Skip to content

Commit e70313c

Browse files
authored
Longfei/update8004 (#2441)
* update 8004 tutorial * updates 8004 * remove unneeded file * rename title
1 parent 6974500 commit e70313c

File tree

1 file changed

+15
-18
lines changed

1 file changed

+15
-18
lines changed

builder-cookbook/filecoin-pin/erc-8004-agent-registration.md

Lines changed: 15 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,13 @@ Learn how to register a trustless autonomous agent on the ERC-8004 Identity Regi
1010

1111
## Overview
1212

13-
This tutorial walks you through registering an [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) compliant agent with cryptographically-verified persistent storage on Filecoin. You'll create an agent card (metadata describing your agent's capabilities), store it on Filecoin with daily PDP (Proof of Data Possession) storage proofs, and register it on-chain as an NFT on Base Sepolia.
13+
This tutorial walks you through registering an [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) compliant agent with cryptographically-verified persistent storage on Filecoin. You'll create an agent card (metadata describing your agent's capabilities), store it on Filecoin & IPFS using Filecoin Pin, and register it on-chain as an NFT on Base Sepolia.
1414

1515
**What you'll learn:**
1616
- How to create an ERC-8004 compliant agent card
1717
- How to use Filecoin Pin for persistent, verifiable storage
1818
- How to register an agent on the ERC-8004 Identity Registry
19-
- How to verify PDP proofs and on-chain registration
19+
- How to verify Filecoin storage proofs and on-chain registration
2020

2121
**What you'll build:**
2222
A GitHub Integration Agent that references GitHub's official MCP server, demonstrating how real-world services can be integrated with ERC-8004.
@@ -75,15 +75,16 @@ You'll need testnet tokens on **two networks**:
7575

7676
#### Filecoin Calibration Testnet
7777
- **tFIL** (testnet Filecoin) - For gas fees
78-
- Faucet: https://faucet.calibnet.chainsafe-fil.io/funds.html
79-
- Amount needed: ~5 tFIL
78+
- Request tFIL from [Filecoin Calibration Faucet](https://faucet.calibnet.chainsafe-fil.io/funds.html)
79+
- Amount requested: 100 tFIL
8080
- **USDFC** (Filecoin stablecoin) - For storage payments
81-
- Mint at: https://stg.usdfc.net (requires tFIL as collateral)
81+
- Request test USDFC from [Filecoin Calibnet USDFC Faucet](https://forest-explorer.chainsafe.dev/faucet/calibnet_usdfc)
82+
- Or Mint at [USDFC website](https://stg.usdfc.net) (requires at tFIL as collateral)
8283
- Amount needed: ~5 USDFC
8384

8485
#### Base Sepolia Testnet
8586
- **Sepolia ETH** - For NFT minting and registration
86-
- Faucet: https://www.alchemy.com/faucets/base-sepolia
87+
- Request test ETH on Base Sepolia on [Faucet](https://www.alchemy.com/faucets/base-sepolia)
8788
- Amount needed: ~0.001 ETH
8889

8990
> **NOTE!** The same Ethereum wallet works on both Filecoin Calibration and Base Sepolia. You only need one private key.
@@ -510,7 +511,7 @@ Replace `<AGENT_ID_DECIMAL>` with your agent's ID (e.g., `56`).
510511

511512
***
512513

513-
## Step 4: Verify Storage and PDP Proofs
514+
## Step 4: Check On-chain Storage Proofs
514515

515516
Finally, let's verify that your agent card is persistently stored with cryptographic proofs.
516517

@@ -522,8 +523,6 @@ Use the Dataset ID from Step 2:
522523
filecoin-pin data-set 933 # Replace with your Dataset ID
523524
```
524525

525-
**Screenshot**: [Terminal showing PDP proof status with storage provider, last proof timestamp, and next proof time]
526-
527526
You'll see output like:
528527

529528
```
@@ -598,8 +597,6 @@ echo "Token URI: $URI"
598597
curl -s "https://ipfs.io/ipfs/<ROOT_CID>/github-agent-card.json" | jq '.endpoints[]'
599598
```
600599

601-
**Screenshot**: [Terminal showing complete discovery workflow with agent card endpoints displayed]
602-
603600
### Summary
604601

605602
✅ Your agent is now:
@@ -622,15 +619,15 @@ npm install -g filecoin-pin
622619

623620
### Issue: `Insufficient USDFC`
624621

625-
**Solution**: Mint more USDFC at https://stg.usdfc.net using tFIL as collateral.
622+
**Solution**: Request more test USDFC at [Filecoin Calibnet USDFC Faucet](https://forest-explorer.chainsafe.dev/faucet/calibnet_usdfc)
626623

627624
### Issue: `Transaction reverted` on Base Sepolia
628625

629626
**Solution**: Check your Base Sepolia ETH balance:
630627
```bash
631628
cast balance <YOUR_ADDRESS> --rpc-url https://sepolia.base.org --ether
632629
```
633-
Get more from the faucet if needed: https://www.alchemy.com/faucets/base-sepolia
630+
Get more from the [faucet](https://www.alchemy.com/faucets/base-sepolia) if needed.
634631

635632
### Issue: IPFS retrieval is slow or fails
636633

@@ -691,11 +688,11 @@ Coming soon, stay tuned!
691688

692689
## Additional Resources
693690

694-
- **ERC-8004 Specification**: https://eips.ethereum.org/EIPS/eip-8004
695-
- **Reference Implementation**: https://github.com/ChaosChain/trustless-agents-erc-ri
696-
- **Filecoin Pin CLI Tutorial**: https://docs.filecoin.io/builder-cookbook/filecoin-pin/filecoin-pin-cli
697-
- **Base Sepolia Explorer**: https://sepolia.basescan.org
698-
- **GitHub MCP Server**: https://github.com/github/github-mcp-server
691+
- [**ERC-8004 Specification**](https://eips.ethereum.org/EIPS/eip-8004)
692+
- [**Reference Implementation**](https://github.com/ChaosChain/trustless-agents-erc-ri)
693+
- [**Filecoin Pin CLI Tutorial**](https://docs.filecoin.io/builder-cookbook/filecoin-pin/filecoin-pin-cli)
694+
- [**Base Sepolia Explorer**](https://sepolia.basescan.org)
695+
- [**GitHub MCP Server**](https://github.com/github/github-mcp-server)
699696

700697
***
701698

0 commit comments

Comments
 (0)