
本文详细阐述了在python中向starknet合约传递长字符串的正确方法。鉴于starknet合约对数组参数的特殊处理方式(需先传递长度再传递元素),以及将字符串视为`u64`字符数组的约定,文章提供了将字符串转换为符合starknet要求的`calldata`格式的实用指南和代码示例,有效解决了“输入参数过长”的常见错误。
当向Starknet合约传递数组类型参数时,无论是整数数组还是字符串(在Starknet中常被视为字符数组),Starknet都有其特定的calldata格式要求。与传统编程语言直接传递数组不同,Starknet要求在实际数组元素之前,首先明确传递数组的长度。
具体来说,一个数组[element1, element2, ..., elementN]在calldata中会被表示为:N, element1, element2, ..., elementN。这里的N代表数组的元素数量。
例如,如果要传递整数数组 [8, 13, 21, 34],其对应的calldata将是 4, 8, 13, 21, 34。其中,4是数组的长度,后面紧跟着四个元素。
对于字符串,Starknet合约通常将其视为一个u64整数数组,其中每个u64代表字符串中的一个字符。这意味着在将字符串传递给合约之前,我们需要将其拆分为单个字符,并将每个字符转换为其对应的整数值(例如ASCII或UTF-8编码的码点)。
立即学习“Python免费学习笔记(深入)”;
当尝试直接将一个长字符串作为单个元素传递给合约时,例如:
calldata=["data:,{\"p\":\"stark-20\",\"op\":\"min","t\",\"tick\":\"STRK\",\"amt\":\"1000\"}"]Starknet会将其视为一个过长的单个参数,从而导致 Input too long for arguments 错误。这是因为Starknet期望的是一个由长度和多个u64字符码点组成的序列,而不是一个原始的、未经处理的字符串。正确的做法是,将字符串分解为字符数组,并按照Starknet的数组约定进行格式化。
为了正确传递长字符串,我们需要执行以下步骤:
下面是一个Python函数,用于将普通字符串转换为Starknet兼容的calldata格式:
def string_to_starknet_calldata(long_string: str) -> list[int]:
"""
将长字符串转换为Starknet合约期望的calldata格式。
字符串被视为u64字符数组,格式为 [长度, 字符1的码点, 字符2的码点, ...]
"""
# 将字符串中的每个字符转换为其Unicode码点
char_codes = [ord(char) for char in long_string]
# 在字符码点数组前添加数组长度
starknet_calldata = [len(char_codes)] + char_codes
return starknet_calldata
# 示例使用
long_data_string = "data:,{\"p\":\"stark-20\",\"op\":\"mint\",\"tick\":\"STRK\",\"amt\":\"1000\"}"
formatted_calldata = string_to_starknet_calldata(long_data_string)
print(f"原始字符串长度: {len(long_data_string)}")
print(f"Starknet calldata (前10个元素): {formatted_calldata[:10]}...")
print(f"Starknet calldata 长度: {len(formatted_calldata)}")将上述转换后的calldata集成到starknet.py库的交易签名和发送流程中,可以解决传递长字符串的问题。
import aiohttp
from starknet_py.net.full_node_client import FullNodeClient
from starknet_py.net.account.account import Account
from starknet_py.net.models import StarknetChainId
from starknet_py.net.signer.stark_curve_signer import KeyPair
from starknet_py.hash.selector import get_selector_from_name
from starknet_py.net.client_models import Call
# 请替换为你的实际配置
node_url = "YOUR_FULL_NODE_URL" # 例如: "https://alpha-mainnet.starknet.io/rpc"
address = 0x123... # 你的账户地址,例如: 0x0...
private_key = 0x456... # 你的私钥,例如: 0x0...
# 目标合约地址和方法选择器
contract_address = 0x07341189e3c96f636a4192cfba8c18deeee33a19c5d0425a26cf96ea42388c4e
selector_name = "inscribe" # 假设合约方法名为 "inscribe"
# 要传递的长字符串数据
long_data_string = "data:,{\"p\":\"stark-20\",\"op\":\"mint\",\"tick\":\"STRK\",\"amt\":\"1000\"}"
# 使用自定义函数转换字符串为Starknet兼容的calldata
starknet_formatted_calldata = string_to_starknet_calldata(long_data_string)
async def send_transaction_with_long_string():
async with aiohttp.TCPConnector(ssl=False) as tcpconnector:
async with aiohttp.ClientSession(connector=tcpconnector, trust_env=True) as session:
full_node_client = FullNodeClient(node_url=node_url, session=session)
account = Account(
client=full_node_client,
address=address,
key_pair=KeyPair.from_private_key(key=private_key),
chain=StarknetChainId.MAINNET,
)
call = Call(
to_addr=contract_address,
selector=get_selector_from_name(selector_name),
calldata=starknet_formatted_calldata # 使用转换后的calldata
)
calls = [call]
# 签名交易
# 注意:max_fee 应该根据实际网络情况和估算费用设置一个合理的值,0 仅为示例。
tx = await account.sign_invoke_transaction(
calls=calls, max_fee=0
)
# 估算费用 (建议在发送前进行,并设置合理的max_fee)
estimated_fee = await account.client.estimate_fee(
tx=tx,
)
print(f"估算费用: {estimated_fee.overall_fee} wei")
# 发送交易 (取消注释以实际发送)
# invoke_response = await account.client.send_transaction(tx=tx)
# print(f"交易发送成功,交易哈希: {invoke_response.transaction_hash}")
# 运行异步函数
# import asyncio
# asyncio.run(send_transaction_with_long_string())在Starknet中向合约传递长字符串时,关键在于理解其对数组参数的特殊处理方式:即先传递数组长度,再传递各个元素。通过将字符串转换为其字符码点的整数数组,并在数组前加上其长度,我们可以构造出符合Starknet要求的calldata,从而避免“输入参数过长”的错误。这种方法不仅适用于字符串,也适用于任何需要以数组形式传递到Starknet合约的数据。掌握这一技巧对于在Python中与Starknet合约进行高效、准确的交互至关重要。
以上就是如何在Python中向Starknet合约传递长字符串的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号