Skip to main content

Complex Cross Contract Call

This example presents 3 instances of complex cross-contract calls. Particularly, it shows:

  1. How to batch multiple function calls to a same contract.
  2. How to call multiple contracts in parallel, each returning a different type.
  3. Different ways of handling the responses in the callback.
Simple Cross-Contract Calls

Check the tutorial on how to use simple cross-contract calls

Obtaining the Cross Contract Call Exampleโ€‹

You have two options to start the Donation Example:

  1. You can use the app through Github Codespaces, which will open a web-based interactive environment.
  2. Clone the repository locally and use it from your computer.
CodespacesClone locally
Open in GitHub Codespaces๐ŸŒ https://github.com/near-examples/cross-contract-calls

Structure of the Exampleโ€‹

The smart contract is available in two flavors: Rust and JavaScript

โ”Œโ”€โ”€ sandbox-ts # sandbox testing
โ”‚    โ”œโ”€โ”€ external-contracts
โ”‚    โ”‚    โ”œโ”€โ”€ counter.wasm
โ”‚    โ”‚    โ”œโ”€โ”€ guest-book.wasm
โ”‚    โ”‚    โ””โ”€โ”€ hello-near.wasm
โ”‚    โ””โ”€โ”€ main.ava.ts
โ”œโ”€โ”€ src # contract's code
โ”‚    โ”œโ”€โ”€ internal
โ”‚    โ”‚    โ”œโ”€โ”€ batch_actions.ts
โ”‚    โ”‚    โ”œโ”€โ”€ constants.ts
โ”‚    โ”‚    โ”œโ”€โ”€ multiple_contracts.ts
โ”‚    โ”‚    โ”œโ”€โ”€ similar_contracts.ts
โ”‚    โ”‚    โ””โ”€โ”€ utils.ts
โ”‚    โ””โ”€โ”€ contract.ts
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ tsconfig.json

Smart Contractโ€‹

Batch Actionsโ€‹

You can aggregate multiple actions directed towards one same contract into a batched transaction. Methods called this way are executed sequentially, with the added benefit that, if one fails then they all get reverted.

contract-advanced-ts/src/contract.ts
loading...

Getting the Last Responseโ€‹

In this case, the callback has access to the value returned by the last action from the chain.

contract-advanced-ts/src/contract.ts
loading...

Calling Multiple Contractsโ€‹

A contract can call multiple other contracts. This creates multiple transactions that execute all in parallel. If one of them fails the rest ARE NOT REVERTED.

contract-advanced-ts/src/contract.ts
loading...

Getting All Responsesโ€‹

In this case, the callback has access to an array of responses, which have either the value returned by each call, or an error message.

contract-advanced-ts/src/contract.ts
loading...

Multiple Calls - Same Result Typeโ€‹

This example is a particular case of the previous one (Calling Multiple Contracts). It simply showcases a different way to check the results by directly accessing the promise_result array.

In this case, we call multiple contracts that will return the same type:

contract-advanced-ts/src/contract.ts
loading...

Getting All Responsesโ€‹

In this case, the callback again has access to an array of responses, which we can iterate checking the results.

contract-advanced-ts/src/contract.ts
loading...

Testing the Contractโ€‹

The contract readily includes a set of unit and sandbox testing to validate its functionality. To execute the tests, run the following commands:

cd contract-advanced-ts
yarn
yarn test
tip

The integration tests use a sandbox to create NEAR users and simulate interactions with the contract.

Deploying the Contract to the NEAR networkโ€‹

In order to deploy the contract you will need to create a NEAR account.

# Optional - create an account
near create-account <accountId> --useFaucet

# Deploy the contract
cd contract-advanced-ts
yarn build
near deploy <accountId> ./build/cross_contract.wasm --initFunction init --initArgs '{"hello_account":"hello.near-example.testnet","guestbook_account":"guestbook_account.near-example.testnet","counter_account":"counter_account.near-example.testnet"}'

CLI: Interacting with the Contractโ€‹

To interact with the contract through the console, you can use the following commands:

# Execute contracts sequentially
# Replace <accountId> with your account ID
near call <accountId> batch_actions --accountId <accountId> --gas 300000000000000   

# Execute contracts in parallel
# Replace <accountId> with your account ID
near call <accountId>  multiple_contracts --accountId <accountId> --gas 300000000000000   

# Execute multiple instances of the same contract in parallel
# Replace <accountId> with your account ID
near call <accountId> similar_contracts --accountId <accountId> --gas 300000000000000
info

If at some point you get an "Exceeded the prepaid gas" error, try to increase the gas amount used within the functions when calling other contracts

Versioning for this article

At the time of this writing, this example works with the following versions:

  • near-cli: 4.0.13
  • node: 18.19.1
  • rustc: 1.77.0
Was this page helpful?
Need some help? Chat with us or check our Dev Resources!
Twitter
Telegram
Discord
Zulip