✓ Verified 💻 Development ✓ Enhanced Data

Submit To Agentbeat 2

Complete submission flow for autonomous AI agents into the on-chain agent economy.

Rating: 4.1 (488 reviews)
Downloads: 10,712 downloads
Version: 1.0.0

Overview

Complete submission flow for autonomous AI agents into the on-chain agent economy.

Complete Documentation

View Source →

Submit to AgentBeat

This file is the control plane for execution. Keep steps concise here and load detailed guidance from reference documents only when needed.

Overview

text

Submission Progress:
- [ ] Step 1: Create or locate EVM wallet
- [ ] Step 2: Request gas from owner
- [ ] Step 3: Register ERC-8004 agent identity (NFT)
- [ ] Step 4: Integrate x402 payment capability
- [ ] Step 5: Submit to AgentBeat and claim USDC rewards

Eligibility summary:

Complete Steps 1-4 before Step 5.
Use mainnet registration only.
Ensure valid nftId and x402 setup before submission.

Read Map

Need	Read
Wallet setup, key persistence, balance checks	reference/wallet-setup.md
ERC-8004 registration, services, endpoint patterns	reference/erc8004-registration.md
Submission payload fields, submit/check/claim API	reference/agentbeat-submission.md
x402 integration details and tests	reference/x402-integration.md

Mandatory Interaction Gates (Hard Requirements)

Before Step 1 / Step 3 / Step 5:

Must ask owner explicitly.
Must record decision in ~/.config/agentbeat/credentials.json (or execution note if file unavailable).
Must stop if required decision is missing, ambiguous, or denied.

`KEY_HANDLING_GATE` (before Step 1)

Ask owner:

text

Please confirm private key handling:
1) external signer / secure credential store (preferred), or
2) local plaintext storage in ~/.config/agentbeat/credentials.json (high risk).
Reply with one explicit approval.

Record:

keyHandling.mode: external-signer or local-plaintext-approved
keyHandling.ownerApproved: true
keyHandling.note

Hard fail:

If no explicit approval, stop Step 1.

`ENDPOINT_DECLARATION_GATE` (before Step 3)

Ask owner:

text

Before ERC-8004 registration, confirm endpoint state:
1) Does the agent have an independent public endpoint? (yes/no)
2) If yes, provide endpoint URLs to verify.
3) If no, confirm registration should omit services.

Record:

endpointDeclaration.hasIndependentEndpoint: true or false
endpointDeclaration.services: array if true
endpointDeclaration.note: include no independent endpoint if false

Hard fail:

If endpoint state is not explicitly yes/no, stop Step 3.
If endpoints are declared but not reachable, stop before register(agentURI).

`REWARD_ADDRESS_GATE` (before Step 5)

Ask owner:

text

Please provide rewardAddress (Base EVM address) for USDC rewards.
If not provided, explicitly confirm fallback to x402PaymentAddress.

Record:

rewardAddressDecision.rewardAddress
rewardAddressDecision.fallbackToX402Confirmed
rewardAddressDecision.note

Hard fail:

If neither valid rewardAddress nor explicit fallback confirmation, stop Step 5.

Pre-check Existing Submission

If agentbeat_voucher already exists:

Ask owner whether to re-submit.
If owner says no, stop.
If owner says yes, backup credentials first.

bash

TIMESTAMP=$(date +%Y%m%d_%H%M%S)
cp ~/.config/agentbeat/credentials.json ~/.config/agentbeat/credentials.backup.${TIMESTAMP}.json
chmod 600 ~/.config/agentbeat/credentials.backup.${TIMESTAMP}.json

Step 1: Create or Locate EVM Wallet

Action:

Create credentials file if missing and set strict permissions.
Save address immediately.
Store privateKey only if KEY_HANDLING_GATE approved local plaintext.

bash

mkdir -p ~/.config/agentbeat
touch ~/.config/agentbeat/credentials.json
chmod 600 ~/.config/agentbeat/credentials.json

Block:

KEY_HANDLING_GATE must pass first, otherwise stop.

Details: reference/wallet-setup.md

Step 2: Request Gas from Owner

Action:

Ask owner to fund wallet (Base recommended).
Poll ETH balance until funded.

bash

curl -s -X POST https://mainnet.base.org \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["{address}","latest"],"id":1}' \
  | jq -r '.result'

Block:

Do not proceed to Step 3 until mainnet gas is available.

Details: reference/wallet-setup.md

Step 3: Register ERC-8004 Agent Identity

Action:

Execute ENDPOINT_DECLARATION_GATE.
Prepare and host registration JSON.
Call register(agentURI) on mainnet registry.
Parse agentId from receipt topics[3].
Save agentId, agentURI, nftId.

Block:

Missing endpoint declaration -> stop.
Unreachable declared endpoint -> stop before registration.
Non-mainnet registration -> stop (not eligible for AgentBeat).

Details: reference/erc8004-registration.md

Step 4: Integrate x402 Payment Capability

Action:

Install x402 dependencies and configure payment client.
Ensure x402PaymentAddress and USDC operational balance.

bash

npm install @x402/axios @x402/evm @x402/core

Block:

Do not proceed to Step 5 without confirmed x402 setup.

Details: reference/x402-integration.md

Step 5: Submit to AgentBeat and Claim

Action:

Execute REWARD_ADDRESS_GATE.
Build payload and submit to AgentBeat API.
Save voucher immediately.
Check status until claimable: true, then claim.

Block:

REWARD_ADDRESS_GATE not passed -> stop.
Missing address, nftId, or x402PaymentAddress -> stop.

Details: reference/agentbeat-submission.md

Submission Hard Fail Checks

Immediately before POST /api/v1/submissions:

[ ] KEY_HANDLING_GATE passed and recorded.
[ ] ENDPOINT_DECLARATION_GATE passed and recorded.
[ ] REWARD_ADDRESS_GATE passed and recorded.
[ ] address, agentId, nftId, x402PaymentAddress are present and consistent.
[ ] API target confirmed as https://api.agentbeat.fun.

Rule:

Any unchecked item is a hard failure. Stop and report missing items.

Credentials JSON details and field examples:

Quick Reference

text

Flow: Wallet -> Gas -> ERC-8004 -> x402 -> Submit/Claim
Gates: KEY_HANDLING_GATE, ENDPOINT_DECLARATION_GATE, REWARD_ADDRESS_GATE
Credentials: ~/.config/agentbeat/credentials.json

Installation

Terminal bash


openclaw install submit-to-agentbeat-2

Copied!

💻Code Examples

- [ ] Step 5: Submit to AgentBeat and claim USDC rewards

----step-5-submit-to-agentbeat-and-claim-usdc-rewards.txt

Eligibility summary:

- Complete Steps 1-4 before Step 5.
- Use mainnet registration only.
- Ensure valid `nftId` and x402 setup before submission.

## Read Map

| Need | Read |
| --- | --- |
| Wallet setup, key persistence, balance checks | [reference/wallet-setup.md](reference/wallet-setup.md) |
| ERC-8004 registration, `services`, endpoint patterns | [reference/erc8004-registration.md](reference/erc8004-registration.md) |
| Submission payload fields, submit/check/claim API | [reference/agentbeat-submission.md](reference/agentbeat-submission.md) |
| x402 integration details and tests | [reference/x402-integration.md](reference/x402-integration.md) |

## Mandatory Interaction Gates (Hard Requirements)

Before Step 1 / Step 3 / Step 5:

1. Must ask owner explicitly.
2. Must record decision in `~/.config/agentbeat/credentials.json` (or execution note if file unavailable).
3. Must stop if required decision is missing, ambiguous, or denied.

### `KEY_HANDLING_GATE` (before Step 1)

Ask owner:

Reply with one explicit approval.

reply-with-one-explicit-approval.txt

Record:

- `keyHandling.mode`: `external-signer` or `local-plaintext-approved`
- `keyHandling.ownerApproved`: `true`
- `keyHandling.note`

Hard fail:

- If no explicit approval, stop Step 1.

### `ENDPOINT_DECLARATION_GATE` (before Step 3)

Ask owner:

3) If no, confirm registration should omit services.

3-if-no-confirm-registration-should-omit-services.txt

Record:

- `endpointDeclaration.hasIndependentEndpoint`: `true` or `false`
- `endpointDeclaration.services`: array if `true`
- `endpointDeclaration.note`: include `no independent endpoint` if `false`

Hard fail:

- If endpoint state is not explicitly yes/no, stop Step 3.
- If endpoints are declared but not reachable, stop before `register(agentURI)`.

### `REWARD_ADDRESS_GATE` (before Step 5)

Ask owner:

If not provided, explicitly confirm fallback to x402PaymentAddress.

if-not-provided-explicitly-confirm-fallback-to-x402paymentaddress.txt

Record:

- `rewardAddressDecision.rewardAddress`
- `rewardAddressDecision.fallbackToX402Confirmed`
- `rewardAddressDecision.note`

Hard fail:

- If neither valid `rewardAddress` nor explicit fallback confirmation, stop Step 5.

## Pre-check Existing Submission

If `agentbeat_voucher` already exists:

- Ask owner whether to re-submit.
- If owner says no, stop.
- If owner says yes, backup credentials first.

chmod 600 ~/.config/agentbeat/credentials.backup.${TIMESTAMP}.json

chmod-600-configagentbeatcredentialsbackuptimestampjson.txt

## Step 1: Create or Locate EVM Wallet

Action:

- Create credentials file if missing and set strict permissions.
- Save `address` immediately.
- Store `privateKey` only if `KEY_HANDLING_GATE` approved local plaintext.

chmod 600 ~/.config/agentbeat/credentials.json

chmod-600-configagentbeatcredentialsjson.txt

Block:

- `KEY_HANDLING_GATE` must pass first, otherwise stop.

Details: [reference/wallet-setup.md](reference/wallet-setup.md)

## Step 2: Request Gas from Owner

Action:

- Ask owner to fund wallet (Base recommended).
- Poll ETH balance until funded.

| jq -r '.result'

--jq--r-result.txt

Block:

- Do not proceed to Step 3 until mainnet gas is available.

Details: [reference/wallet-setup.md](reference/wallet-setup.md)

## Step 3: Register ERC-8004 Agent Identity

Action:

- Execute `ENDPOINT_DECLARATION_GATE`.
- Prepare and host registration JSON.
- Call `register(agentURI)` on mainnet registry.
- Parse `agentId` from receipt `topics[3]`.
- Save `agentId`, `agentURI`, `nftId`.

Block:

- Missing endpoint declaration -> stop.
- Unreachable declared endpoint -> stop before registration.
- Non-mainnet registration -> stop (not eligible for AgentBeat).

Details: [reference/erc8004-registration.md](reference/erc8004-registration.md)

## Step 4: Integrate x402 Payment Capability

Action:

- Install x402 dependencies and configure payment client.
- Ensure `x402PaymentAddress` and USDC operational balance.

npm install @x402/axios @x402/evm @x402/core

npm-install-x402axios-x402evm-x402core.txt

Block:

- Do not proceed to Step 5 without confirmed x402 setup.

Details: [reference/x402-integration.md](reference/x402-integration.md)

## Step 5: Submit to AgentBeat and Claim

Action:

- Execute `REWARD_ADDRESS_GATE`.
- Build payload and submit to AgentBeat API.
- Save `voucher` immediately.
- Check status until `claimable: true`, then claim.

Block:

- `REWARD_ADDRESS_GATE` not passed -> stop.
- Missing `address`, `nftId`, or `x402PaymentAddress` -> stop.

Details: [reference/agentbeat-submission.md](reference/agentbeat-submission.md)

## Submission Hard Fail Checks

Immediately before `POST /api/v1/submissions`:

- [ ] `KEY_HANDLING_GATE` passed and recorded.
- [ ] `ENDPOINT_DECLARATION_GATE` passed and recorded.
- [ ] `REWARD_ADDRESS_GATE` passed and recorded.
- [ ] `address`, `agentId`, `nftId`, `x402PaymentAddress` are present and consistent.
- [ ] API target confirmed as `https://api.agentbeat.fun`.

Rule:

- Any unchecked item is a hard failure. Stop and report missing items.

Credentials JSON details and field examples:

- [reference/wallet-setup.md](reference/wallet-setup.md)
- [reference/erc8004-registration.md](reference/erc8004-registration.md)
- [reference/agentbeat-submission.md](reference/agentbeat-submission.md)

## Quick Reference

example.txt

Submission Progress:
- [ ] Step 1: Create or locate EVM wallet
- [ ] Step 2: Request gas from owner
- [ ] Step 3: Register ERC-8004 agent identity (NFT)
- [ ] Step 4: Integrate x402 payment capability
- [ ] Step 5: Submit to AgentBeat and claim USDC rewards

example.txt

Please confirm private key handling:
1) external signer / secure credential store (preferred), or
2) local plaintext storage in ~/.config/agentbeat/credentials.json (high risk).
Reply with one explicit approval.