在Starknet合约中传递长字符串的Python指南

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.net.client_models import Call
from starknet_py.hash.selector import get_selector_from_name

# 假设这些变量已根据您的实际环境进行定义
NODE_URL = "YOUR_NODE_URL" # 例如 "https://alpha-mainnet.starknet.io/rpc/v0.4"
ACCOUNT_ADDRESS = 0x123... # 您的账户地址
PRIVATE_KEY = 0xabc... # 您的私钥

def string_to_calldata_array(long_string: str) -> list[int]:
    """
    将长字符串转换为Starknet calldata所需的u64数组格式。
    每个字符转换为其ASCII值，并以数组长度作为前缀。
    """
    # 将字符串中的每个字符转换为其ASCII值
    # 注意：这里假设合约期望的是ASCII编码。对于非ASCII字符，
    # 您可能需要将字符串先编码为字节串（如.encode('utf-8')），
    # 然后将每个字节转换为整数。
    char_values = [ord(char) for char in long_string]

    # Starknet calldata约定：[长度, 元素1, 元素2, ...]
    return [len(char_values)] + char_values

async def invoke_contract_with_long_string():
    """
    演示如何向Starknet合约传递一个长字符串。
    """
    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=ACCOUNT_ADDRESS,
                key_pair=KeyPair.from_private_key(key=PRIVATE_KEY),
                chain=StarknetChainId.MAINNET,
            )

            # 待传递的长字符串数据
            long_data_string = "data:,{\"p\":\"stark-20\",\"op\":\"mint\",\"tick\":\"STRK\",\"amt\":\"1000\"}"

            # 将长字符串转换为Starknet calldata所需的格式
            calldata_for_string = string_to_calldata_array(long_data_string)

            # 目标合约地址和函数选择器
            target_contract_address = 0x07341189e3c96f636a4192cfba8c18deeee33a19c5d0425a26cf96ea42388c4e
            selector_name = "inscribe"

            call = Call(
                to_addr=target_contract_address,
                selector=get_selector_from_name(selector_name),
                calldata=calldata_for_string # 使用正确编码后的calldata
            )

            calls = [call]

            # 签署交易（初始max_fee可设为0，之后进行估算）
            tx = await account.sign_invoke_transaction(
                calls=calls, max_fee=0
            )

            # 估算交易费用
            estimated_fee = await account.client.estimate_fee(tx=tx)
            print(f"估算费用: {estimated_fee.overall_fee} wei")

            # 实际发送交易前，通常需要用估算出的费用更新交易并重新签名
            # tx.max_fee = estimated_fee.overall_fee
            # invoke_response = await account.client.send_transaction(tx)
            # print(f"交易哈希: {invoke_response.transaction_hash}")

# 在实际运行中，您需要取消以下行的注释
# import asyncio
# asyncio.run(invoke_contract_with_long_string())