WOLFRAM

Wolfram 语言与系统参考资料中心

BlockchainContractValue (Tezos)

BlockchainContractValue[caddr]

获取地址为 caddr 的 Tezos 合约的存储.

BlockchainContractValue[caddr,annot]

从地址为 caddr 的 Tezos 合约存储中获取注释为 annot 的存储值.

BlockchainContractValue[caddr,opList]

在对地址为 caddr 的合约存储应用 Michelson 配对操作列表 opList 后获取存储值.

BlockchainContractValue[caddr,assoc]

获取地址为 caddr 的合约的存储，其属性在 Association assoc 中定义.

更多信息

  • 给出 Tezos 合约存储的信息. 默认情况下，其目标为最新区块的状态.
  • BlockchainContractValue 有默认值为 $BlockchainBase 的选项 BlockchainBase.
  • BlockchainContractValue 的可能选项包括：
  • BlockchainBase $BlockchainBase使用的区块链和网络
    MaxItems 20返回大映射项的最大数量
  • BlockchainContractValue 至多返回 1000 个大映射元素.
  • BlockchainContractValue[caddr] 返回地址为 caddr 的 Tezos 合约存储.
  • BlockchainContractValue[caddr,annot] 返回带注释存储值，其中 annot 必须为一个 String 表达式.
  • BlockchainContractValue[caddr,opList] 返回存储值，其中 opList 必须为一个包含代表 Michelson 配对操作的 Left 和 Right 表达式的 List.
  • 若 BlockchainContractValue 返回了一个有注释的 Michelson 配对，其会返回一个有下列属性的关联嵌套列表：
  • "Annotation"Michelson 配对内部存储值的注释
    "Value"Michelson 配对内部的存储值
  • 若在合约存储内没有与 annot 或 opList 关联的的存储值，则返回 Missing["NotAvailable"].
  • BlockchainContractValue[caddr,assoc] 返回有额外参数的存储值，其中 Association assoc 可有如下属性：
  • "BlockNumber"与区块链特定状态关联的区块数
    "Annotation"用于在 Michelson 配对中识别存储值的字符串
    "OperationList"表示 Michelson 配对操作的 Left 和 Right 表达式列表
    "KeyHash"与 Michelson 大映射元素关联的键值哈希
  • 若 BlockchainContractValue 返回 Michelson 大映射，则其会返回有如下属性的关联列表：
  • "Key"与 Michelson 大映射元素相关联的键值
    "KeyHash"与 Michelson 大映射元素相关联的键值哈希
    "Value"与 Michelson 大映射元素相关联的值
  • 当 BlockchainContractValue[caddr,assoc] 中的关联 assoc 包含 "KeyHash" 元素，会返回与指定 "KeyHash" 对应的大映射元素值.

范例

打开所有单元 关闭所有单元

基本范例  (6)

获取 USDtz 代币合约的存储：

Wolfram Language code: BlockchainContractValue["KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9", BlockchainBase -> "Tezos"]

使用注释获取 USDtz 令牌合约的总令牌供给量：

Wolfram Language code: BlockchainContractValue["KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9", "totalSupply", BlockchainBase -> "Tezos"]

使用 Michelson 操作配对列表获取 USDtz 令牌合约的总令牌供给量：

Wolfram Language code: BlockchainContractValue["KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9", {Right, Right, Right}, BlockchainBase -> "Tezos"]

获取区块 1000000 处的 USDtz 令牌合约的总令牌供给量：

Wolfram Language code: BlockchainContractValue["KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9", <|"BlockNumber" -> 1000000, "Annotation" -> "totalSupply"|>, BlockchainBase -> "Tezos"]

从 USDtz 令牌合约账本中获取 20 个最近更新的余额. 注释存储值 "ledger" 是一个大映射，所以会返回关联列表：

Wolfram Language code: BlockchainContractValue["KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9", "ledger", BlockchainBase -> "Tezos"]//Dataset

存储值也可通过使用 Michelson 配对操作列表进行指定：

Wolfram Language code: BlockchainContractValue["KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9", <|"OperationList" -> {Left}|>, BlockchainBase -> "Tezos"]//Dataset

从 USDtz 令牌合约余额的账户中获取特定条目：

Wolfram Language code: BlockchainContractValue["KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9", <|"Annotation" -> "ledger", "KeyHash" -> "expruHyMf4t2ySAEtxfTTBiwV4bRP53rXLWMopohqPjaabi5wzvyAV"|>, BlockchainBase -> "Tezos"]

选项  (3)

BlockchainBase  (2)

Mainnet  (1)

在主网 (mainnet) 中获取 Tezos 合约的存储：

Wolfram Language code: BlockchainContractValue["KT1S5iPRQ612wcNm6mXDqDhTNegGFcvTV7vM", BlockchainBase -> {"Tezos", "Mainnet"}]

Testnet  (1)

在测试网 (testnet) 中获取 Tezos 合约的存储：

Wolfram Language code: contract = First[DeleteMissing[Lookup[BlockchainAddressData["tz1YeQkgxvzVroTyMh72DrmNRsyzQfsBmxt8", "TransactionList", BlockchainBase -> {"Tezos", "Testnet"}], "Contract"]]]
Wolfram Language code: BlockchainContractValue[contract, BlockchainBase -> {"Tezos", "Testnet"}]

MaxItems  (1)

列出 "royalties" 大映射中最近更新的 5 个大映射元素：

Wolfram Language code: BlockchainContractValue["KT1Hkg5qeNhfwpKW4fXvq7HGZB9z2EnmCCA9", "royalties", BlockchainBase -> "Tezos", MaxItems -> 5]//Dataset

可能存在的问题  (1)

当引用存储值时，"Annotation" 和 "OperationList" 筛选器不能同时通过：

Wolfram Language code: BlockchainContractValue["KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9", <|"Annotation" -> "ledger", "OperationList" -> {Right, Right}, "KeyHash" -> "expruHyMf4t2ySAEtxfTTBiwV4bRP53rXLWMopohqPjaabi5wzvyAV"|>, BlockchainBase -> "Tezos"]
Wolfram Research (2020)，BlockchainContractValue，Wolfram 语言函数，https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

文本

Wolfram Research (2020)，BlockchainContractValue，Wolfram 语言函数，https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

CMS

Wolfram 语言. 2020. "BlockchainContractValue." Wolfram 语言与系统参考资料中心. Wolfram Research. https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

APA

Wolfram 语言. (2020). BlockchainContractValue. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html 年

BibTeX

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

BibLaTeX

@online{reference.wolfram_2026_blockchaincontractvalue, organization={Wolfram Research}, title={BlockchainContractValue}, year={2020}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html}, note=[Accessed: 09-August-2026]}