Skip to content
Documentation

Getting started with ELYX.

Seven steps from a connected wallet to an agent operating under your rules. For the HTTP API, SDK and webhooks, see the developer reference.

Launch AppAPI reference
  1. 1Launch App

    Connect a wallet

    Sign in with an EVM wallet that supports custom networks (MetaMask, Rabby, Bitget Wallet, OKX Wallet) by signing a one-time message. ELYX adds Elysium to the wallet for you. No password and no seed phrase.

  2. 2Accounts

    Create an account

    Deploy a Safe smart account on Elysium mainnet. Add co-owners and set the threshold: the number of owner signatures required. Your wallet signs the deployment.

  3. 3Vaults

    Fund a vault

    Each account holds one or more vaults. Deposit USDC or HYPE from your wallet. Funds stay in the vault under owner control.

  4. 4Agents

    Create an agent with limits

    Name the agent, choose its vault and set on-chain spending limits per asset and period, the counterparties it may pay, and policy defaults. Owners sign the Safe transaction that adds its executor.

  5. 5Developers

    Issue a session token

    Create a session for the agent: allowed actions, a USD spending allowance, a rate limit and an expiry. The eas_ token is shown once.

  6. 6API

    Submit intents

    The agent calls the API with structured intents: swap, pay, transfer, allocate or return. ELYX validates, checks policies, simulates and signs within limits.

  7. 7Approvals

    Approve when asked

    Intents above your approval threshold wait for owners. Review the request and approve or reject with your wallet, on-chain for vault funds.

  8. Building an integration? The developer reference covers credentials, intents, execution states, payments, approvals and webhook signatures.

    Developer reference
Concepts

Glossary

The ten terms used across the app and the API.

Account
A Safe smart account on Elysium mainnet. Owners are wallets that sign its transactions; the threshold is how many must sign.
Vault
A Safe owned by the account's owners. Holds the capital. Can be frozen by owners.
Agent
Autonomous software authorized to act for an account, through its executor, within limits and policies.
Executor
The agent's dedicated key, derived server-side and never stored. A delegate of the ELYX spending limit module; never a Safe owner, so it can never sign Safe transactions.
Spending limit
An on-chain limit in the ELYX Safe module: an amount of one asset per period, payable only to allow-listed destinations. The hard ceiling.
Policy
A deterministic rule ELYX checks before signing: limits, thresholds, assets, protocols, counterparties, actions, time windows, frequency, slippage.
Approval
An owner decision on an intent or change. EIP-712 signatures over the Safe transaction for vault funds; wallet-signed messages for agent-wallet swaps and change requests.
Execution
The lifecycle of one intent: validation, policy check, optional approval, simulation, signing and confirmation.
Settlement
The final record of a confirmed execution: Elysium transaction hash, block, amounts and fee.
Counterparty
A registered recipient (wallet, business, agent, protocol or API provider) with an organizational trust state and optional daily limit.