BlockchainContractValue (for Tezos)

BlockchainContractValue[caddr]

gets the storage of a Tezos contract with address caddr.

BlockchainContractValue[caddr,annot]

gets the storage value annotated with annot from the storage of a Tezos contract with address caddr.

BlockchainContractValue[caddr,opList]

gets the storage value after applying the list of Michelson pair operations opList to the storage of a Tezos contract with address caddr.

BlockchainContractValue[caddr,assoc]

gets the storage of a Tezos contract with address caddr with the properties defined in Association assoc.

Details

  • Gives information about the storage of a Tezos contract. By default, it targets the state of the latest block.
  • BlockchainContractValue has option BlockchainBase with default value $BlockchainBase.
  • BlockchainContractValue[caddr] returns the storage of a Tezos contract with address caddr.
  • BlockchainContractValue[caddr,annot] returns the annotated storage value where annot must be a String expression.
  • BlockchainContractValue[caddr,opList] returns the storage value where opList must be a List containing Left and Right expressions representing Michelson pair operations.
  • If an annotated Michelson pair is returned by BlockchainContractValue, it returns a nested list of associations with the following properties:
  • "Annotation"annotation of the storage value inside a Michelson pair
    "Value"storage value inside a Michelson pair
  • If there is no storage value associated with annot or opList in the storage of the contract, Missing["NotAvailable"] is returned.
  • BlockchainContractValue[caddr,assoc] returns the storage value with additional parameters where Association assoc can have the following properties:
  • "BlockNumber"block number associated to a specific state of the blockchain
    "Annotation"string used to identify a storage value in a Michelson pair
    "OperationList"list of Left and Right expressions representing Michelson pair operations
    "KeyHash"key hash associated to a Michelson big map element
  • If a Michelson big map is returned by BlockchainContractValue, it returns instead, a list of associations with the following properties:
  • "Key"key associated to a Michelson big map element
    "KeyHash"key hash associated to a Michelson big map element
    "Value"value associated to a Michelson big map element
  • When the association assoc in BlockchainContractValue[caddr,assoc] contains the "KeyHash" element, the big map element value corresponding to the specified "KeyHash" is returned.
  • Historical big maps data is currently not supported.

Examples

open allclose all

Basic Examples  (6)

Get the storage of the USDtz token contract:

Get the total supply of tokens of the USDtz token contract using an annotation:

Get the total supply of tokens of the USDtz token contract using a list of Michelson operation pairs:

Get the total supply of tokens of the USDtz token contract at the block 1000000:

Get the ledger of balances of the USDtz token contract. The annotated storage value "ledger" is a big map, so a list of associations will be returned:

The storage value can also be specified by using a Michelson pair operations list:

Get a specific entry from the ledger of balances of the USDtz token contract:

Options  (2)

BlockchainBase  (2)

Mainnet  (1)

Get the storage of a Tezos contract in mainnet:

Testnet  (1)

Get the storage of a Tezos contract in testnet:

Possible Issues  (2)

When referencing a storage value, the "Annotation" and "OperationList" filters cannot be passed together:

Historical big maps data is currently not supported:

Wolfram Research (2020), BlockchainContractValue, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

Text

Wolfram Research (2020), BlockchainContractValue, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

BibTeX

@misc{reference.wolfram_2021_blockchaincontractvalue, author="Wolfram Research", title="{BlockchainContractValue}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html}", note=[Accessed: 28-July-2021 ]}

BibLaTeX

@online{reference.wolfram_2021_blockchaincontractvalue, organization={Wolfram Research}, title={BlockchainContractValue}, year={2020}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html}, note=[Accessed: 28-July-2021 ]}

CMS

Wolfram Language. 2020. "BlockchainContractValue." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

APA

Wolfram Language. (2020). BlockchainContractValue. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html