DOCSEARCHbyAlgolia
Submit Docs

t3rn Universal Execution Protocol

website·Indexed 34 days ago

https://docs.t3rn.io/intro

Documentation for t3rn, a Universal Execution Protocol for coordinating trustless smart contract execution across multiple blockchains. Includes guides on becoming an Executor, AIxecutor setup, protocol architecture, tokenomics for the $TRN token, and resources for order flow, gas costs, and network security.

Tokens
8.3K
Snippets
30
Records
62
Agent score
61%

What's inside t3rn

  1. Overview of t3rn Executors

    Executors are off-chain agents that act as market makers to fulfill cross-chain orders within the t3rn protocol. They earn fees and rewards by competing in a free-market environment. The lifecycle of an order fulfillment is: submit order -> bid -> execute -> submit proof -> get reward. Once a transaction is finalized, an inclusion proof is submitted to the t3rn protocol to unlock the reward on the t3rn blockchain.

  2. Overview of the t3rn Universal Execution Protocol

    t3rn is a Universal Execution Protocol that allows smart contracts to operate across multiple EVM and non-EVM blockchains atomically and with full composability. It eliminates the need for fragile bridges or complex custom integrations by providing a unified layer for coordinating smart contracts, capital, and computation across ecosystems.

  3. Overview of t3rn Universal Execution Protocol

    t3rn is a Universal Execution Protocol designed to coordinate smart contract logic across multiple blockchains as a single, unified process. Unlike traditional bridging that focuses on moving tokens, t3rn enables contracts on one blockchain to synchronously call, interact with, and trigger contracts on other chains with atomic finality, removing the need for wrapping assets or rewriting logic.

  4. Overview of t3rn Executors and Intent-Based Interoperability

    Executors in the t3rn network facilitate cross-chain interoperability using an intent-based model. Instead of traditional step-by-step transactions, users express an 'intent' (e.g., a token swap or staking), and Executors handle the execution across multiple blockchain networks. Key responsibilities of Executors include bidding on orders, executing transactions, processing claims, and batching attestations to reduce gas costs and optimize efficiency.

  6. t3rn security auditing and testing standards

    t3rn smart contracts are subjected to rigorous testing and third-party audits to ensure reliability:

    • Auditing Partners: Audits have been conducted by Halborn, Quantstamp, and SR Labs.
    • Testing Strategy: The protocol uses unit and integration tests that simulate high-traffic scenarios and complex cross-chain interactions to identify edge cases.

  7. Optimize cross-chain execution with AIxecutors

    AIxecutors are a class of autonomous Executors powered by AI that dynamically optimize cross-chain performance. They move beyond basic task fulfillment by reacting to live market data and network conditions.

    Key capabilities of AIxecutors include:

    • Routing transactions based on real-time pricing and latency.
    • Adapting strategies based on slippage and fees.
    • Rebalancing capital across networks for optimal liquidity.
    • Handling RPC disruptions or network congestion without human intervention.
    • Coordinating AI-native agent networks to execute complex goals (e.g., maximizing yield across Curve, Venus, and EigenLayer simultaneously with atomicity).

  8. Understand the role and workflow of t3rn Executors

    Executors are off-chain agents that act as market makers to fulfill cross-chain orders in exchange for fees and rewards.

    The operational workflow for an Executor is:

    1. Submit Order: A cross-chain transaction is triggered on the t3rn protocol.
    2. Bid: Executors compete in a reverse bidding process (starting from the user's maximum reward and moving downwards) to win the right to execute the transaction.
    3. Execute: The winning Executor carries out the transaction.
    4. Submit Proof: Once finalized, an inclusion proof is generated and submitted to the t3rn protocol to prove correct execution.
    5. Get Reward: The reward is unlocked for the Executor on the t3rn blockchain.

    Executors are responsible for managing their own liquidity and moving funds across chains via centralized exchanges, OTC, or other methods.

  9. Install AIxecutor binary on macOS

    Download and extract the latest AIxecutor binary for macOS. It is recommended to create a dedicated t3rn directory for the installation.
    # Create and navigate to t3rn directory
mkdir t3rn
cd t3rn

# Download latest release
curl -s https://api.github.com/repos/t3rn/aixecutor-release/releases/latest | \
grep -o '"tag_name": "[^"]*' | \
cut -d'"' -f4 | \
xargs -I {} curl -LO https://github.com/t3rn/aixecutor-release/releases/download/{}/aixecutor-macosx-{}.tar.gz

# Extract the archive
tar -xzf aixecutor-macosx-*.tar.gz

# Navigate to the AIxecutor binary location
cd aixecutor/aixecutor/bin

  10. Process and claim rewards for executed orders

    After successful execution, Executors must fetch and process claims to receive rewards.

    1. Fetching: The Executor fetches pending claims (e.g., 🔃 Pending claims fetch completed).
    2. Status Recovery: The system may run recoverOrderStatus to verify the current state of an order on a specific network (e.g., Arbitrum).
    3. Claim Transmission: Once the system confirms 🌺🏆 Order is claimable, the Executor transmits the claim using the gmpPayloadL2.
    4. Distribution: The BRNRewardsDistributed event is emitted when rewards are officially allocated to the Executor.

  11. Run AIxecutor in the foreground or background

    Start the AIxecutor by executing the binary. For production or long-term operation, use a terminal multiplexer like screen or tmux to keep the process running after detaching.
    # Foreground start
./aixecutor

# Background start using screen
sudo apt-get install screen
screen -S t3rn-aixecutor
./aixecutor
# Detach: Ctrl + A, then D
# Reattach: screen -r t3rn-executor

# Background start using tmux
sudo apt-get install tmux
tmux new -s t3rn-aixecutor
./aixecutor
# Detach: Ctrl + B, then D
# Reattach: tmux attach -t t3rn-executor