examples/soroban_invoke_contract_function.py
"""This example shows how to call the Soroban contract.
The current API is in an unstable state.
1. You need to follow [this tutorial](https://soroban.stellar.org/docs/tutorials/deploy-to-local-network)
to deploy the [Hello World contract](https://github.com/stellar/soroban-examples/tree/main/hello_world) first.
2. Install Stellar Python SDK from pypi:
pip install --upgrade stellar-sdk
3. Modify the necessary parameters in this script, then run it.
"""
import time
from stellar_sdk import Keypair, Network, SorobanServer, TransactionBuilder, scval
from stellar_sdk import xdr as stellar_xdr
from stellar_sdk.exceptions import PrepareTransactionException
from stellar_sdk.soroban_rpc import GetTransactionStatus, SendTransactionStatus
# TODO: You need to replace the following parameters according to the actual situation
secret = "SAAPYAPTTRZMCUZFPG3G66V4ZMHTK4TWA6NS7U4F7Z3IMUD52EK4DDEV"
rpc_server_url = "https://soroban-testnet.stellar.org:443"
contract_id = "CDJO3KQKJFHFEZY2ZSWS4CTZEAZUO2SZNRWO2Y7QQS4X3UWSOLFJHSS3"
network_passphrase = Network.TESTNET_NETWORK_PASSPHRASE
kp = Keypair.from_secret(secret)
soroban_server = SorobanServer(rpc_server_url)
source = soroban_server.load_account(kp.public_key)
# Let's build a transaction that invokes the `hello` function.
tx = (
TransactionBuilder(source, network_passphrase, base_fee=100)
.set_timeout(300)
.append_invoke_contract_function_op(
contract_id=contract_id,
function_name="hello",
parameters=[scval.to_symbol("world")],
)
.build()
)
print(f"XDR: {tx.to_xdr()}")
try:
tx = soroban_server.prepare_transaction(tx)
except PrepareTransactionException as e:
print(f"Got exception: {e.simulate_transaction_response}")
raise e
tx.sign(kp)
print(f"Signed XDR: {tx.to_xdr()}")
send_transaction_data = soroban_server.send_transaction(tx)
print(f"sent transaction: {send_transaction_data}")
if send_transaction_data.status != SendTransactionStatus.PENDING:
raise Exception("send transaction failed")
while True:
print("waiting for transaction to be confirmed...")
get_transaction_data = soroban_server.get_transaction(send_transaction_data.hash)
if get_transaction_data.status != GetTransactionStatus.NOT_FOUND:
break
time.sleep(3)
print(f"transaction: {get_transaction_data}")
if get_transaction_data.status == GetTransactionStatus.SUCCESS:
assert get_transaction_data.result_meta_xdr is not None
transaction_meta = stellar_xdr.TransactionMeta.from_xdr(
get_transaction_data.result_meta_xdr
)
result = transaction_meta.v3.soroban_meta.return_value # type: ignore[union-attr]
output = [x.sym.sc_symbol.decode() for x in result.vec.sc_vec] # type: ignore
print(f"transaction result: {output}")
else:
print(f"Transaction failed: {get_transaction_data.result_xdr}")