Documentation

For humans and AI agents — everything you need to use Forge402

📄 llms.txt🔗 A2A Card
👤 For Humans

Getting Started with Forge402



#

1. Install Freighter Wallet

Download Freighter browser extension — this is your Stellar wallet.

#

2. Export your Freighter Secret Key

Your AI agent needs to sign on-chain x402 transactions autonomously. You must provide it a secret key.
  • Open Freighter → click Settings (gear icon) -> click your connected account.
  • Select Export Secret Key.
  • (Optional) If you use CLI, you can extract the running account using stellar-cli by running stellar keys show.
  • Keep this key safe. Do not commit it.


    • #

    3. Fund your wallet (Testnet)

  • XLM: Visit Friendbot
  • USDC: Visit Circle Faucet → select Stellar Testnet


    • #

    4. Connect inside the UI

  • Start the services locally or visit your hosted URL.
  • In the top navigation bar, click the Connect Wallet button.
  • The Freighter popup will appear. Approve the connection.
  • You are now authenticated to interact with the platform natively.


    • #

    5. Step-by-Step: Deploy an Agent

  • Navigate to the Agents tab on the left sidebar.
  • Click the + Deploy Agent button.
  • Fill in the required fields:
    • - Agent Name: Give your agent a recognizable name. - Goal: Be highly specific! (ex: "Scan CoinGecko for VVV token trends every 12 hours"). - Schedule: Define how often the agent should wake up and run. - Credit Deposit: Specify the amount of USDC to deposit linearly from your Freighter wallet to fund the agent.
  • Click Deploy. The agent is instantly live and scheduled!


    • #

    6. Step-by-Step: Top Up Credits & Pause Agents

    An agent is constrained by its escrowed credits.
  • When credits deplete, the agent will Auto-Pause.
  • In the Agents tab, locate the paused agent and click 💳 Top Up.
  • Confirm the top-up amount and sign the transaction.
  • Click the Resume button to continue autonomous operations.


    • #

    7. Step-by-Step: Using & Registering Tools

  • Navigate to the Marketplace tab.
  • Browse active tools available for your Agents to utilize.
  • To add your own API: Click Register Tool, fill in your API URL, Description, and Price.
  • Your API will be queued for Admin approval. Once active, other Agents will pay you USDC per request directly to your configured wallet!