Solana Agent Registry / 8004 identity
Register your agent Turn the quickstart into an identity owned by your connected wallet.
Describe your actual agent, its real services, and its OASF capabilities in the metadata studio. Publish the validated JSON to a public HTTPS or IPFS URI. Prepare registration, review account rent and effects, then sign with your wallet. Read the finalized asset. Update an agent Manage the registration URI and bounded onchain metadata.
Read the current agent URI and ownership before changing its profile. Publish a replacement document and prepare the URI update. Set or delete metadata entries separately. Make an entry immutable only when you intend it to be permanent. Transfer ownership Move an agent asset to its intended recipient with an explicit wallet review.
Inspect the live Core owner and immutable creator; they can differ. Enter the recipient, review the transfer, and sign with the current owner wallet. Read the finalized agent to verify the recipient. Use Sync cached owner after an external wallet transfer. Organize an agent fleet Build a real collection without copying the example’s invented fleet.
Build collection metadata and publish it to IPFS. Reuse its canonical c1: pointer. Associate that pointer with one real agent at a time, using the immutable creator wallet. Add optional parent relationships. Review every permanent lock independently. Build a feedback trail Publish a metric, inspect its commitment, respond, or revoke your review.
Choose the real agent asset and record the interaction’s exact metric and optional quality score. Sign feedback with the reviewer wallet. An owner cannot review their own agent. Use the recorded client and feedback index to append a response, or revoke feedback that belongs to your wallet. Review and sign in your wallet The example’s prepare and sign split is built into every operation here.
The server prepares a transaction with no wallet private key. A new asset keypair stays in your browser. Review the payer, required signers, programs, effects, and wallet debit. Sign the exact packet in your wallet. The server retains the submitted signature and reconciles it. Retry the same saved packet after an uncertain response. Request verifiable feedback Open, finalize, or close a live ProofPass request.
The immutable agent creator opens a request for a named reviewer and a specific business reference. The reviewer inspects the live request and finalizes real 8004 feedback. Fees come from the current onchain configuration. Read the session below. Close an eligible unfinalized request to apply the onchain refund rules. Bind x402 interaction evidence Verify signed interaction bytes before requesting a review.
Discover a real service’s x402 requirements. Match its recipient to the agent’s operational wallet before any payment. Verify the original request and response hashes, task reference, and agent signature. Payment settlement requires its own receipt. Only after the interaction is verified should the designated reviewer finalize ProofPass feedback. Read a live ProofPass request Inspect a known session, or read requests opened by an immutable creator. Lookup does not open a request or send a transaction.
Verify an x402 interaction Paste the evidence JSON from a service: original request and response bytes as base64, plus its signed 8004 interaction data. The verifier checks the declared registry, live operational wallet, hashes, and signature.
A valid signature and matching hashes verify interaction evidence. They do not prove payment settlement. This registry has no configured mainnet $CLAWD payment facilitator. Reference documents The registry adapts the SDK’s mainnet reads and transaction builders. Global administrator commands, irreversible burning, and arbitrary URL probing remain outside public agent workflows.