
本文详细阐述了在starknet网络中,如何通过python正确地向合约传递长字符串参数。针对常见的“input too long for arguments”错误,文章揭示了starknet处理数组类型参数的底层机制,即要求先传递数组长度,再传递数组元素。通过将长字符串转换为字符的`u64`数组,并按照指定格式构建`calldata`,开发者可以有效解决长字符串传递问题,确保交易成功执行。
在Starknet上与合约交互时,尤其是在传递复杂数据类型如长字符串或数组时,理解其底层参数传递规则至关重要。当尝试将一个较长的字符串作为单一参数直接传递给合约时,常见的错误是收到 Input too long for arguments。这表明Starknet合约的ABI(Application Binary Interface)对参数的预期格式与我们直接传递字符串的方式不符。
Starknet合约在处理数组类型参数时,有一套明确的约定:
这意味着,如果一个合约方法期望接收一个字符串(在Starknet中,通常被视为一个字符数组或felt数组),你不能简单地将整个字符串作为一个felt值传递。相反,你需要将字符串拆分成单个字符,将每个字符转换为一个u64(或felt),然后按照“长度-元素1-元素2...”的顺序构建calldata。
例如,如果合约期望接收一个包含 [8, 13, 21, 34] 的数组,那么正确的 calldata 结构应该是 [4, 8, 13, 21, 34]。这里的 4 代表数组的长度,紧随其后的是数组的四个元素。
calldata = [
    4,      # 数组长度
    8,      # 数组元素 1
    13,     # 数组元素 2
    21,     # 数组元素 3
    34      # 数组元素 4
]要将长字符串传递给Starknet合约,我们需要遵循上述数组传递规则。具体步骤如下:
下面是一个使用 starknet.py 库的示例,演示了如何将一个长字符串 data:,{"p":"stark-20","op":"mint","tick":"STRK","amt":"1000"} 正确地传递给Starknet合约。
import asyncio
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.models import KeyPair
from starknet_py.hash.selector import get_selector_from_name
from starknet_py.net.client_models import Call
# 假设的节点URL、账户地址和私钥
node_url = "YOUR_NODE_URL"  # 例如: "https://alpha-mainnet.starknet.io/rpc/v0.4"
address = 0x0123...  # 你的账户地址
private_key = 0xabcd... # 你的私钥
async def invoke_contract_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,
            )
            # 目标合约地址和方法选择器
            contract_address = 0x07341189e3c96f636a4192cfba8c18deeee33a19c5d0425a26cf96ea42388c4e
            selector = get_selector_from_name("inscribe")
            # 要传递的长字符串
            long_string = "data:,{\"p\":\"stark-20\",\"op\":\"mint\",\"tick\":\"STRK\",\"amt\":\"1000\"}"
            # 1. 将字符串转换为字符的整数数组
            # 每个字符的ord()值就是其Unicode编码,可以直接作为felt使用
            string_as_felt_array = [ord(char) for char in long_string]
            # 2. 构建calldata:先是长度,然后是所有字符的整数值
            # 注意:calldata的第一个元素是数组的长度
            calldata_for_string_argument = [len(string_as_felt_array)] + string_as_felt_array
            print(f"Original string length: {len(long_string)}")
            print(f"Calldata prepared (first few elements): {calldata_for_string_argument[:10]}...")
            print(f"Calldata total length: {len(calldata_for_string_argument)}")
            # 构建Call对象
            call = Call(
                to_addr=contract_address,
                selector=selector,
                calldata=calldata_for_string_argument
            )
            calls = [call]
            # 签名并发送交易
            # 注意:max_fee通常需要根据实际网络情况设置一个合理的值
            # 这里为了示例,先设置为0,实际操作中会先预估费用
            tx = await account.sign_invoke_transaction(
                calls=calls, max_fee=0 # 初始设置为0,后续会通过estimate_fee更新
            )
            # 估算交易费用
            estimated_fee = await account.client.estimate_fee(tx=tx)
            print(f"Estimated fee: {estimated_fee.overall_fee}")
            # 重新签名并发送交易,使用估算出的费用
            tx_with_fee = await account.sign_invoke_transaction(
                calls=calls, max_fee=estimated_fee.overall_fee
            )
            resp = await account.client.send_transaction(tx_with_fee)
            print(f"Transaction sent with hash: {resp.transaction_hash}")
# 运行异步函数
if __name__ == "__main__":
    asyncio.run(invoke_contract_with_long_string())向Starknet合约传递长字符串的关键在于理解其处理数组类型参数的约定:先传递数组长度,再传递数组元素。通过将字符串分解为单个字符的u64数组,并按照此约定构造 calldata,可以有效解决 Input too long for arguments 错误,确保交易的顺利执行。遵循本文提供的步骤和注意事项,将有助于开发者更高效、准确地与Starknet合约进行交互。
以上就是Starknet合约长字符串参数传递指南的详细内容,更多请关注php中文网其它相关文章!
 
                        
                        每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
 
                Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号