Contract ABIs define the interface by which clients typically interact with Ethereum smart contracts. They are defined as JSON artifacts. Here’s an ABI for a very simple contract:
[{"constant":true,"inputs":[],"name":"whoAmI","outputs":[{"name":"me","type":"address"}],"payable":false,"stateMutability":"view","type":"function"}]
In order to work with a smart contract in sbt-ethereum, you need to associate it’s address with an ABI.
When a smart contract is compiled, an ABI is often generated as a compilation artifact. However, there is not necessarily a one-to-one mapping between contracts and ABIs. For example, one mode of deploying Ethereum smart contracts is as a “storage proxy”, whose user-facing interface is determined by the contract it delegates to rather than anything the compiler might know about the contract. Even if you do not have “the ABI” for a contract, you may know that it implements some standard interface (like the ERC20 token standard, for example), in which case you can interact with the contract through an ABI that describes that interface.
Default Contract ABIs
When you compile and deploy a smart contract with sbt-ethereum, the deployment address automatically becomes the default contract ABI for the contract. When you wish to interact with a smart contract you have not yourself deployed (or if the compilation ABI is not the appropriate interface), you can set associate a default ABI with an address via ethContractAbiDefaultImport or ethContractAbiDefaultSet.
Default ABI associations are store in the sbt-ethereum “shoebox” and are persistent. Once set, they will remain unless they are overwritten or explicitly dropped.
Override Contract ABIs
Sometimes you may temporarily wish to use an ABI that should not be the default ABI for a contract. ABI overrides define temporary associations of ABIs with contract addresses that only endure within a single sbt-ethereum session.
When sbt-ethereum commands expect an ABI, you can refer to it via the address of a contract for which that ABI is already the default. (You can also refer to ABIs by their hashes, which sbt-ethereum computes after normalizing the JSON ABIs by removing unnecessary spaces, and sometimes exposes, see e.g. ethContractAbiAliasList.)
However, it may be convenient to name ABIs you interact with frequently and may wish to reuse. So sbt-ethereum permits you to define ABI aliases. To refer to ABI aliases where sbt-ethereum expects an ABI, prefix the alias name with abi:.
sbt-ethereum also defines aliases for some standard ABIs. These are prefixed with abi:standard:. For the moment, the only supported standard ABI alias is abi:standard:erc20.
Function Call Encoding and Decoding
A contracts functions and the form its calls will take (arguments, return values) are specified by contract ABIs. ethContractAbiCallEncode and ethContractAbiCallDecode permit you to generate the hex bytes that a function call translates to, or to decode those bytes back into a function name and arguments.
Usage:
> ethContractAbiAliasDrop <abi-alias>
Removes an alias for a contract abi from the sbt-ethereum shoebox database.
Example:
> ethContractAbiAliasDrop abi:whoami
[info] Abi alias 'abi:whoami' successfully dropped.
[info] Refreshing caches.
[success] Total time: 0 s, completed Jan 27, 2019 11:16:29 PM
Usage:
> ethContractAbiAliasList
Lists all ABI aliases that have been defined in the sbt-ethereum shoebox database.
Example:
> ethContractAbiAliasList
+--------------------+--------------------------------------------------------------------+
| ABI Alias | ABI Hash |
+--------------------+--------------------------------------------------------------------+
| abi:fortune | 0x1c40488a3a264071e539f1a36abe69e4ade3751b15d839af83e015fc2dc6be12 |
| abi:standard:erc20 | 0xa405c7571bcf24cac5ee2f1280f3dee84133398287f650235c093a1384c9a2dd |
| abi:whoami | 0x093def1bd67f0c4c3f6d578cd27f5135d1fa62e2f652fab0ee79933b23a37c27 |
+--------------------+--------------------------------------------------------------------+
[success] Total time: 0 s, completed Jan 27, 2019 11:20:33 PM
Usage:
> ethContractAbiAliasSet <new-abi-alias> <abi-as-hex-address-or-address-alias-or-ens-address-or-abi-hash-or-abi-alias>
Defines a new ABI alias, based on the address of a contract associated with the ABI, an ABI hash, or an existing ABI alias.
Examples:
> ethContractAbiAliasSet whoami 0xe599f637dfb705e56589951a5d777afdaf618b5b
> ethContractAbiAliasSet whoami who-am-i
> ethContractAbiAliasSet whoami who-am-i.eth
> ethContractAbiAliasSet whoami 0x093def1bd67f0c4c3f6d578cd27f5135d1fa62e2f652fab0ee79933b23a37c27
> ethContractAbiAliasSet whoami abi:some-other-alias
Example response:
[info] Abi alias 'abi:whoami' successfully bound to ABI found via ABI associated with contract address '0xe599f637dfb705e56589951a5d777afdaf618b5b' on chain with ID 1.
[info] Refreshing caches.
[success] Total time: 0 s, completed Jan 27, 2019 11:34:46 PM
Usage:
> ethContractAbiCallDecode <abi-as-hex-address-or-address-alias-or-ens-address-or-abi-hash-or-abi-alias> <hex-encoded-function-call>
Decodes a hex-encoded function call (second argument) back into the function name and arguments, based on a specified ABI (first argument).
Example:
> ethContractAbiCallDecode abi:fortune 0x4cf373e6000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000135468697320697320616e206578616d706c652e00000000000000000000000000
Function called: addFortune(string)
Arg 1 [name=fortune, type=string]: "This is an example."
[success] Total time: 0 s, completed Jan 27, 2019 11:50:18 PM
Usage:
> ethContractAbiCallEncode <abi-as-hex-address-or-address-alias-or-ens-address-or-abi-hash-or-abi-alias> <function-name> [<function-args-if-any>*]
Encodes a function call with its arguments (if any) into a hex message, based on a specified ABI (first argument).
Example:
> ethContractAbiCallEncode abi:fortune addFortune "This is an example."
Encoded data:
0x4cf373e6000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000135468697320697320616e206578616d706c652e00000000000000000000000000
[success] Total time: 0 s, completed Jan 27, 2019 11:49:50 PM
Usage:
> ethContractAbiDefaultDrop <address-as-hex-or-ens-or-alias>
Removes any default contract ABI that may have been associated with an address for the current EIP-155 Chain ID.
Examples:
> ethContractAbiDefaultDrop 0x82ea8ab1e836272322f376a5f71d5a34a71688f1
> ethContractAbiDefaultDrop fortune
> ethContractAbiDefaultDrop some-address.eth
Example response:
[info] Previously imported or set ABI for contract with address '0x82ea8ab1e836272322f376a5f71d5a34a71688f1' (on chain with ID 1) has been dropped.
[success] Total time: 0 s, completed Feb 15, 2019 4:28:47 PM
Usage:
> ethContractAbiDefaultList [optional-regex-to-filter-rows]
Lists all addresses and contract ABIs for which a default association has been defined, either explicitly or automatically upon deployment, for the current EIP-155 Chain ID.
Example:
> ethContractAbiDefaultList
+--------------------------------------------+--------------------------------------------------------------------+----------+
| Address | ABI Hash | Source |
+--------------------------------------------+--------------------------------------------------------------------+----------+
| 0x82ea8ab1e836272322f376a5f71d5a34a71688f1 | 0x1c40488a3a264071e539f1a36abe69e4ade3751b15d839af83e015fc2dc6be12 | Imported | <-- address aliases: ['fortune','fortune3']
+--------------------------------------------+--------------------------------------------------------------------+----------+
[success] Total time: 0 s, completed Feb 15, 2019 4:36:10 PM
Usage:
> ethContractAbiDefaultImport <address-as-hex-or-ens-or-alias>
Imports an ABI into the sbt-ethereum shoebox database, and associates it as the default ABI for the given address for the current EIP-155 Chain ID.
ABIs can be imported manually by cut-and-paste. They can also be imported automatically from Etherscan, if an Etherscan API key has been set.
When importing from Etherscan, sbt_ethereum will now check to see if the contract appears to be an EIP-1967 transparent proxy. If the contract does appear to be a proxy, sbt-ethereum will offer to download the API of the proxied contract, which is usually what you’ll prefer. (Whichever ABI you choose, you can have access to alternative ABI by using ethContractAbiImport without supplying a contract address. Paste in the alternative ABI when queried, then define an ABI alias. To use the alternative ABI, use ethContractAbiOverrideSet.)
Example:
> ethContractAbiImport AaveLendingPoolV2-Proxy
An Etherscan API key has been set. Would you like to try to import the ABI for this address from Etherscan? [y/n] y
Checking to see if address '0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9' is an EIP-1967 transparent proxy.
'0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9' appears to be an EIP-1967 transparent proxy for '0xC6845a5C768BF8D7681249f8927877Efda425baf'.
Import the ABI of the proxied contract instead of the apparent proxy? [y/n] y
Will attempt to import the ABI associated with proxied contract at '0xC6845a5C768BF8D7681249f8927877Efda425baf'.
Attempting to fetch ABI for address '0xC6845a5C768BF8D7681249f8927877Efda425baf' from Etherscan.
ABI found:
[{"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"constant":true,"payable":false,"inputs":[],"name":"FLASHLOAN_PREMIUM_TOTAL","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"constant":true,"payable":false,"inputs":[],"name":"LENDINGPOOL_REVISION","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"constant":true,"payable":false,"inputs":[],"name":"MAX_NUMBER_RESERVES","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"constant":true,"payable":false,"inputs":[],"name":"MAX_STABLE_RATE_BORROW_SIZE_PERCENT","stateMutability":"view","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"amount","type":"uint256","internalType":"uint256"},{"name":"interestRateMode","type":"uint256","internalType":"uint256"},{"name":"referralCode","type":"uint16","internalType":"uint16"},{"name":"onBehalfOf","type":"address","internalType":"address"}],"name":"borrow","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"amount","type":"uint256","internalType":"uint256"},{"name":"onBehalfOf","type":"address","internalType":"address"},{"name":"referralCode","type":"uint16","internalType":"uint16"}],"name":"deposit","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"from","type":"address","internalType":"address"},{"name":"to","type":"address","internalType":"address"},{"name":"amount","type":"uint256","internalType":"uint256"},{"name":"balanceFromBefore","type":"uint256","internalType":"uint256"},{"name":"balanceToBefore","type":"uint256","internalType":"uint256"}],"name":"finalizeTransfer","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"receiverAddress","type":"address","internalType":"address"},{"name":"assets","type":"address[]","internalType":"address[]"},{"name":"amounts","type":"uint256[]","internalType":"uint256[]"},{"name":"modes","type":"uint256[]","internalType":"uint256[]"},{"name":"onBehalfOf","type":"address","internalType":"address"},{"name":"params","type":"bytes","internalType":"bytes"},{"name":"referralCode","type":"uint16","internalType":"uint16"}],"name":"flashLoan","stateMutability":"nonpayable","type":"function"},{"outputs":[{"name":"","type":"address","internalType":"contract ILendingPoolAddressesProvider"}],"constant":true,"payable":false,"inputs":[],"name":"getAddressesProvider","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"tuple","internalType":"struct DataTypes.ReserveConfigurationMap"}],"constant":true,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"}],"name":"getConfiguration","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"tuple","internalType":"struct DataTypes.ReserveData"}],"constant":true,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"}],"name":"getReserveData","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"constant":true,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"}],"name":"getReserveNormalizedIncome","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"constant":true,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"}],"name":"getReserveNormalizedVariableDebt","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"address[]","internalType":"address[]"}],"constant":true,"payable":false,"inputs":[],"name":"getReservesList","stateMutability":"view","type":"function"},{"outputs":[{"name":"totalCollateralETH","type":"uint256","internalType":"uint256"},{"name":"totalDebtETH","type":"uint256","internalType":"uint256"},{"name":"availableBorrowsETH","type":"uint256","internalType":"uint256"},{"name":"currentLiquidationThreshold","type":"uint256","internalType":"uint256"},{"name":"ltv","type":"uint256","internalType":"uint256"},{"name":"healthFactor","type":"uint256","internalType":"uint256"}],"constant":true,"payable":false,"inputs":[{"name":"user","type":"address","internalType":"address"}],"name":"getUserAccountData","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"tuple","internalType":"struct DataTypes.UserConfigurationMap"}],"constant":true,"payable":false,"inputs":[{"name":"user","type":"address","internalType":"address"}],"name":"getUserConfiguration","stateMutability":"view","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"aTokenAddress","type":"address","internalType":"address"},{"name":"stableDebtAddress","type":"address","internalType":"address"},{"name":"variableDebtAddress","type":"address","internalType":"address"},{"name":"interestRateStrategyAddress","type":"address","internalType":"address"}],"name":"initReserve","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"provider","type":"address","internalType":"contract ILendingPoolAddressesProvider"}],"name":"initialize","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"collateralAsset","type":"address","internalType":"address"},{"name":"debtAsset","type":"address","internalType":"address"},{"name":"user","type":"address","internalType":"address"},{"name":"debtToCover","type":"uint256","internalType":"uint256"},{"name":"receiveAToken","type":"bool","internalType":"bool"}],"name":"liquidationCall","stateMutability":"nonpayable","type":"function"},{"outputs":[{"name":"","type":"bool","internalType":"bool"}],"constant":true,"payable":false,"inputs":[],"name":"paused","stateMutability":"view","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"user","type":"address","internalType":"address"}],"name":"rebalanceStableBorrowRate","stateMutability":"nonpayable","type":"function"},{"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"amount","type":"uint256","internalType":"uint256"},{"name":"rateMode","type":"uint256","internalType":"uint256"},{"name":"onBehalfOf","type":"address","internalType":"address"}],"name":"repay","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"configuration","type":"uint256","internalType":"uint256"}],"name":"setConfiguration","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"val","type":"bool","internalType":"bool"}],"name":"setPause","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"rateStrategyAddress","type":"address","internalType":"address"}],"name":"setReserveInterestRateStrategyAddress","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"useAsCollateral","type":"bool","internalType":"bool"}],"name":"setUserUseReserveAsCollateral","stateMutability":"nonpayable","type":"function"},{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"rateMode","type":"uint256","internalType":"uint256"}],"name":"swapBorrowRateMode","stateMutability":"nonpayable","type":"function"},{"outputs":[{"name":"","type":"uint256","internalType":"uint256"}],"constant":false,"payable":false,"inputs":[{"name":"asset","type":"address","internalType":"address"},{"name":"amount","type":"uint256","internalType":"uint256"},{"name":"to","type":"address","internalType":"address"}],"name":"withdraw","stateMutability":"nonpayable","type":"function"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":false,"internalType":"address"},{"name":"onBehalfOf","type":"address","indexed":true,"internalType":"address"},{"name":"amount","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"borrowRateMode","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"borrowRate","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"referral","type":"uint16","indexed":true,"internalType":"uint16"}],"name":"Borrow","anonymous":false,"type":"event"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":false,"internalType":"address"},{"name":"onBehalfOf","type":"address","indexed":true,"internalType":"address"},{"name":"amount","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"referral","type":"uint16","indexed":true,"internalType":"uint16"}],"name":"Deposit","anonymous":false,"type":"event"},{"inputs":[{"name":"target","type":"address","indexed":true,"internalType":"address"},{"name":"initiator","type":"address","indexed":true,"internalType":"address"},{"name":"asset","type":"address","indexed":true,"internalType":"address"},{"name":"amount","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"premium","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"referralCode","type":"uint16","indexed":false,"internalType":"uint16"}],"name":"FlashLoan","anonymous":false,"type":"event"},{"inputs":[{"name":"collateralAsset","type":"address","indexed":true,"internalType":"address"},{"name":"debtAsset","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":true,"internalType":"address"},{"name":"debtToCover","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"liquidatedCollateralAmount","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"liquidator","type":"address","indexed":false,"internalType":"address"},{"name":"receiveAToken","type":"bool","indexed":false,"internalType":"bool"}],"name":"LiquidationCall","anonymous":false,"type":"event"},{"inputs":[],"name":"Paused","anonymous":false,"type":"event"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":true,"internalType":"address"}],"name":"RebalanceStableBorrowRate","anonymous":false,"type":"event"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":true,"internalType":"address"},{"name":"repayer","type":"address","indexed":true,"internalType":"address"},{"name":"amount","type":"uint256","indexed":false,"internalType":"uint256"}],"name":"Repay","anonymous":false,"type":"event"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"liquidityRate","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"stableBorrowRate","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"variableBorrowRate","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"liquidityIndex","type":"uint256","indexed":false,"internalType":"uint256"},{"name":"variableBorrowIndex","type":"uint256","indexed":false,"internalType":"uint256"}],"name":"ReserveDataUpdated","anonymous":false,"type":"event"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":true,"internalType":"address"}],"name":"ReserveUsedAsCollateralDisabled","anonymous":false,"type":"event"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":true,"internalType":"address"}],"name":"ReserveUsedAsCollateralEnabled","anonymous":false,"type":"event"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":true,"internalType":"address"},{"name":"rateMode","type":"uint256","indexed":false,"internalType":"uint256"}],"name":"Swap","anonymous":false,"type":"event"},{"inputs":[],"name":"Unpaused","anonymous":false,"type":"event"},{"inputs":[{"name":"reserve","type":"address","indexed":true,"internalType":"address"},{"name":"user","type":"address","indexed":true,"internalType":"address"},{"name":"to","type":"address","indexed":true,"internalType":"address"},{"name":"amount","type":"uint256","indexed":false,"internalType":"uint256"}],"name":"Withdraw","anonymous":false,"type":"event"}]
Use this ABI? [y/n] y
[info] A default ABI is now known for the contract at address 0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9
[info] Refreshing caches.
[success] Total time: 33 s, completed Feb 7, 2021, 6:45:08 AM
Directly pasted ABIs cannot include newlines!
If you are directly pasting an ABI into the console (rather than importing from Etherscan), it can’t be a pretty-printed ABI with newlines. sbt-ethereum expects you to “hit return” only after you have pasted the ABI text. If you have a pretty-printed ABI, condense it, for example using sites like this.
Usage:
> ethContractAbiDefaultSet <address-as-hex-or-ens-or-alias> <abi-as-hex-address-or-address-alias-or-ens-address-or-abi-hash-or-abi-alias>
Creates a default association between an address and an ABI for the current EIP-155 Chain ID.
Addresses may be specified as sbt-ethereum aliases, ENS addresses, or raw hex. ABIs may be specified by explicit ABI aliases, hex ABI hashes, via any address currently associated with the same ABI.
Example:
> ethContractAbiDefaultSet 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 abi:standard:erc20
[info] The ABI previously associated with ABI alias 'abi:standard:erc20' (on chain with ID 1) ABI has been associated with address 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.
Enter an optional alias for the address '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2', now associated with the newly matched ABI (or [return] for none): WETH
[info] Alias 'WETH' now points to address '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2' (for chain with ID 1).
[info] Refreshing caches.
[success] Total time: 8 s, completed Feb 15, 2019 5:14:34 PM
Usage:
> ethContractAbiImport [<address-as-hex-or-ens-or-alias>]
If an address is supplied, this is a shorthand for ethContractAbiDefaultImport. Please see that command for more information. It imports (either via Etherscan or by copy-and-paste) an ABI as the default ABI associated with the given address.
If no address is supplied, it imports the ABI and then prompts your for an ABI alias, by which you can refer to the ABI. Once you have a named ABI, use tasks like ethContractAbiOverrideSet, ethContractAbiDefaultSet, and ethContractAbiPrintPretty
Example:
> ethContractAbiImport
You are importing an ABI unattached to any contract address. You must provide an alias, so you can refer to it later.
Contract ABI: [{"outputs":[],"constant":false,"payable":false,"inputs":[{"name":"fortune","type":"string","internalType":"string"}],"name":"addFortune","stateMutability":"nonpayable","type":"function"},{"outputs":[{"name":"count","type":"uint256","internalType":"uint256"}],"constant":true,"payable":false,"inputs":[],"name":"countFortunes","stateMutability":"view","type":"function"},{"outputs":[{"name":"fortune","type":"string","internalType":"string"}],"constant":true,"payable":false,"inputs":[],"name":"drawFortune","stateMutability":"view","type":"function"},{"outputs":[{"name":"","type":"string","internalType":"string"}],"constant":true,"payable":false,"inputs":[{"name":"","type":"uint256","internalType":"uint256"}],"name":"fortunes","stateMutability":"view","type":"function"},{"inputs":[{"name":"author","type":"address","indexed":false,"internalType":"address"},{"name":"fortune","type":"string","indexed":false,"internalType":"string"}],"name":"FortuneAdded","anonymous":false,"type":"event"},{"payable":false,"inputs":[{"name":"initialFortune","type":"string","internalType":"string"}],"stateMutability":"nonpayable","type":"constructor"}]
Please enter an alias for this ABI: fortune
[info] The ABI has been successfully imported, with alias 'abi:fortune'.
[success] Total time: 22 s, completed Feb 4, 2021, 8:54:09 PM
Directly pasted ABIs cannot include newlines!
If you are directly pasting an ABI into the console (rather than importing from Etherscan), it can’t be a pretty-printed ABI with newlines. sbt-ethereum expects you to “hit return” only after you have pasted the ABI text. If you have a pretty-printed ABI, condense it, for example using sites like this.
Usage:
> ethContractAbiOverride <address-as-hex-or-ens-or-alias> <abi-as-hex-address-or-address-alias-or-ens-address-or-abi-hash-or-abi-alias>
This is a shorthand for ethContractAbiOverrideSet. Please see that command for more information.
Usage:
> ethContractAbiOverrideDrop <address-as-hex-or-ens-or-alias>
Drops any session override of the association between an address and a contract ABI that may have been set (for the current EIP-155 Chain ID).
Example:
> ethContractAbiOverrideDrop fortune
[info] ABI override successfully dropped.
[info] Refreshing caches.
[success] Total time: 0 s, completed Feb 16, 2019 12:31:00 PM
Usage:
> ethContractAbiOverrideDropAll
Drops all session overrides of associations between an address and a contract ABI that may have been set (for the current EIP-155 Chain ID).
Example:
> ethContractAbiOverrideDropAll
[info] ABI overrides on chain with ID 1 successfully dropped.
[info] Refreshing caches.
[success] Total time: 0 s, completed Feb 16, 2019 12:35:46 PM
Usage:
> ethContractAbiOverrideDropList
Lists any session overrides of associations between an address and a contract ABI that may have been set (for the current EIP-155 Chain ID).
Example:
> ethContractAbiOverrideList
+--------------------------------------------+--------------------------------------------------------------------+
| ABI Override Addresses | ABI Hash |
+--------------------------------------------+--------------------------------------------------------------------+
| 0x82ea8ab1e836272322f376a5f71d5a34a71688f1 | 0x1c40488a3a264071e539f1a36abe69e4ade3751b15d839af83e015fc2dc6be12 | <-- address aliases: ['fortune','fortune3'], abi alias: 'abi:oracle'
+--------------------------------------------+--------------------------------------------------------------------+
[success] Total time: 0 s, completed Feb 16, 2019 12:36:27 PM
Usage:
> ethContractAbiOverridePrint fortune
Pretty-prints the JSON of the session override of the contract ABI associated with an ABI (if any).
Example:
> ethContractAbiOverridePrint fortune
Session override of contract ABI for address '0x82ea8ab1e836272322f376a5f71d5a34a71688f1':
[ {
"name" : "drawFortune",
"inputs" : [ ],
"outputs" : [ {
"name" : "fortune",
"type" : "string"
} ],
"constant" : true,
"payable" : false,
"stateMutability" : "view",
"type" : "function"
} ]
[success] Total time: 0 s, completed Feb 16, 2019 12:44:19 PM
Usage:
> ethContractAbiOverrideSet <address-as-hex-or-ens-or-alias> <abi-as-hex-address-or-address-alias-or-ens-address-or-abi-hash-or-abi-alias>
Creates an association between an address and a contract ABI that will override any default association that may have been set, but only for the current session (and EIP-155 Chain ID).
Example:
> ethContractAbiOverrideSet 0x82ea8ab1e836272322f376a5f71d5a34a71688f1 abi:oracle
[info] ABI override successfully set.
[info] Refreshing caches.
[success] Total time: 0 s, completed Feb 16, 2019 12:21:23 PM
Usage:
> ethContractAbiPrint <address-as-hex-or-ens-or-alias>
This is a shorthand for ethContractAbiPrintCompact. Please see that command for more information.
Usage:
> ethContractAbiPrintCompact <address-as-hex-or-ens-or-alias>
Compactly prints the ABI currently effective and associated with an address (for the current EIP-155 Chain ID).
If there is a session override set (see ethContractAbiOverrideSet), it will be the override ABI.
If there is no session override set, it will be the default contract ABI, either defines at deployment time or explicitly imported.
If neither a session override nor default ABI is defined for the address, it will let you know that.
Example:
> ethContractAbiPrintCompact WETH
Contract ABI for ABI associated with contract address '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2' on chain with ID 1:
[{"name":"allowance","inputs":[{"name":"tokenOwner","type":"address"},{"name":"spender","type":"address"}],"outputs":[{"name":"remaining","type":"uint256"}],"constant":true,"payable":false,"stateMutability":"view","type":"function"},{"name":"approve","inputs":[{"name":"spender","type":"address"},{"name":"tokens","type":"uint256"}],"outputs":[{"name":"success","type":"bool"}],"constant":false,"payable":false,"stateMutability":"nonpayable","type":"function"},{"name":"balanceOf","inputs":[{"name":"tokenOwner","type":"address"}],"outputs":[{"name":"balance","type":"uint256"}],"constant":true,"payable":false,"stateMutability":"view","type":"function"},{"name":"totalSupply","inputs":[],"outputs":[{"name":"","type":"uint256"}],"constant":true,"payable":false,"stateMutability":"view","type":"function"},{"name":"transfer","inputs":[{"name":"to","type":"address"},{"name":"tokens","type":"uint256"}],"outputs":[{"name":"success","type":"bool"}],"constant":false,"payable":false,"stateMutability":"nonpayable","type":"function"},{"name":"transferFrom","inputs":[{"name":"from","type":"address"},{"name":"to","type":"address"},{"name":"tokens","type":"uint256"}],"outputs":[{"name":"success","type":"bool"}],"constant":false,"payable":false,"stateMutability":"nonpayable","type":"function"},{"name":"Approval","inputs":[{"name":"tokenOwner","type":"address","indexed":true},{"name":"spender","type":"address","indexed":true},{"name":"tokens","type":"uint256","indexed":false}],"anonymous":false,"type":"event"},{"name":"Transfer","inputs":[{"name":"from","type":"address","indexed":true},{"name":"to","type":"address","indexed":true},{"name":"tokens","type":"uint256","indexed":false}],"anonymous":false,"type":"event"}]
[success] Total time: 0 s, completed Feb 16, 2019 1:01:05 PM
Usage:
> ethContractAbiPrintPretty <address-as-hex-or-ens-or-alias>
Pretty-prints the ABI currently effective and associated with an address (for the current EIP-155 Chain ID).
If there is a session override set (see ethContractAbiOverrideSet), it will be the override ABI.
If there is no session override set, it will be the default contract ABI, either defines at deployment time or explicitly imported.
If neither a session override nor default ABI is defined for the address, it will let you know that.
Example:
> ethContractAbiPrintPretty WETH
Contract ABI for ABI associated with contract address '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2' on chain with ID 1:
[ {
"name" : "allowance",
"inputs" : [ {
"name" : "tokenOwner",
"type" : "address"
}, {
"name" : "spender",
"type" : "address"
} ],
"outputs" : [ {
"name" : "remaining",
"type" : "uint256"
} ],
"constant" : true,
"payable" : false,
"stateMutability" : "view",
"type" : "function"
}, {
"name" : "approve",
"inputs" : [ {
"name" : "spender",
"type" : "address"
}, {
"name" : "tokens",
"type" : "uint256"
} ],
"outputs" : [ {
"name" : "success",
"type" : "bool"
} ],
"constant" : false,
"payable" : false,
"stateMutability" : "nonpayable",
"type" : "function"
}, {
"name" : "balanceOf",
"inputs" : [ {
"name" : "tokenOwner",
"type" : "address"
} ],
"outputs" : [ {
"name" : "balance",
"type" : "uint256"
} ],
"constant" : true,
"payable" : false,
"stateMutability" : "view",
"type" : "function"
}, {
"name" : "totalSupply",
"inputs" : [ ],
"outputs" : [ {
"name" : "",
"type" : "uint256"
} ],
"constant" : true,
"payable" : false,
"stateMutability" : "view",
"type" : "function"
}, {
"name" : "transfer",
"inputs" : [ {
"name" : "to",
"type" : "address"
}, {
"name" : "tokens",
"type" : "uint256"
} ],
"outputs" : [ {
"name" : "success",
"type" : "bool"
} ],
"constant" : false,
"payable" : false,
"stateMutability" : "nonpayable",
"type" : "function"
}, {
"name" : "transferFrom",
"inputs" : [ {
"name" : "from",
"type" : "address"
}, {
"name" : "to",
"type" : "address"
}, {
"name" : "tokens",
"type" : "uint256"
} ],
"outputs" : [ {
"name" : "success",
"type" : "bool"
} ],
"constant" : false,
"payable" : false,
"stateMutability" : "nonpayable",
"type" : "function"
}, {
"name" : "Approval",
"inputs" : [ {
"name" : "tokenOwner",
"type" : "address",
"indexed" : true
}, {
"name" : "spender",
"type" : "address",
"indexed" : true
}, {
"name" : "tokens",
"type" : "uint256",
"indexed" : false
} ],
"anonymous" : false,
"type" : "event"
}, {
"name" : "Transfer",
"inputs" : [ {
"name" : "from",
"type" : "address",
"indexed" : true
}, {
"name" : "to",
"type" : "address",
"indexed" : true
}, {
"name" : "tokens",
"type" : "uint256",
"indexed" : false
} ],
"anonymous" : false,
"type" : "event"
} ]
[success] Total time: 0 s, completed Feb 16, 2019 12:58:44 PM