Feat: Adding Arweave storage via AR.IO Network

.gitignore

@@ -30,6 +30,7 @@ npm-debug.log*
 # Testing
 coverage/
 .nyc_output/
+tests/agent_registration_*.json
 
 # Temporary files
 *.tmp

API_REFERENCE.md

@@ -18,6 +18,9 @@ interface SDKConfig {
   ipfsNodeUrl?: string;
   filecoinPrivateKey?: string;
   pinataJwt?: string;
+  // Arweave configuration
+  arweave?: boolean;
+  arweavePrivateKey?: string;
   // Subgraph configuration
   subgraphUrl?: string;
   subgraphOverrides?: Record<ChainId, string>;
@@ -131,6 +134,7 @@ async getReputationSummary(
 ```typescript
 get web3Client(): Web3Client
 get ipfsClient(): IPFSClient | undefined
+get arweaveClient(): ArweaveClient | undefined
 get subgraphClient(): SubgraphClient | undefined
 ```
 
@@ -190,6 +194,7 @@ getRegistrationFile(): RegistrationFile
 ### Registration Methods
 ```typescript
 async registerIPFS(): Promise<RegistrationFile>
+async registerArweave(): Promise<RegistrationFile>
 async registerHTTP(agentUri: string): Promise<RegistrationFile>
 async setAgentUri(agentUri: string): Promise<void>
 ```
@@ -233,7 +238,7 @@ function formatFeedbackId(
 type AgentId = string; // Format: "chainId:tokenId"
 type ChainId = number;
 type Address = string; // Ethereum address (0x-hex format)
-type URI = string; // https://... or ipfs://...
+type URI = string; // https://..., ipfs://..., or ar://...
 type CID = string; // IPFS CID
 type Timestamp = number; // Unix timestamp in seconds
 type IdemKey = string; // Idempotency key for write operations

README.md

@@ -11,8 +11,8 @@ Agent0 SDK v0.31 enables you to:
 - **OASF taxonomies** - Advertise standardized skills and domains using the Open Agentic Schema Framework (OASF) taxonomies for better discovery and interoperability
 - **Enable permissionless discovery** - Make your agent discoverable by other agents and platforms using rich search by attributes, capabilities, skills, tools, tasks, and x402 support
 - **Build reputation** - Give and receive feedback, retrieve feedback history, and search agents by reputation with cryptographic authentication
-- **Cross-chain registration** - One-line registration with IPFS nodes, Pinata, Filecoin, or HTTP URIs
-- **Public indexing** - Subgraph indexing both on-chain and IPFS data for fast search and retrieval
+- **Cross-chain registration** - One-line registration with IPFS nodes, Pinata, Filecoin, Arweave, or HTTP URIs
+- **Public indexing** - Subgraph indexing both on-chain and decentralized storage (IPFS/Arweave) data for fast search and retrieval
 
 ## ⚠️ Alpha Release
 
@@ -28,7 +28,7 @@ Agent0 SDK v0.31 is in **alpha** with bugs and is not production ready. We're ac
 - npm or yarn package manager
 - Private key for signing transactions (or run in read-only mode)
 - Access to an Ethereum RPC endpoint (e.g., Alchemy, Infura)
-- (Optional) IPFS provider account (Pinata, Filecoin, or local IPFS node)
+- (Optional) Storage provider account (IPFS: Pinata, Filecoin, or local node; or Arweave)
 
 ### Install from npm
 
@@ -202,6 +202,10 @@ const summary = await sdk.getReputationSummary('84532:123'); // Base Sepolia
 ### 5. Give and Retrieve Feedback
 
 ```typescript
+// NOTE: Feedback automatically uses Arweave storage when SDK configured with arweave: true
+// Storage priority: Arweave (permanent) → IPFS (if configured) → On-chain only
+// The fileURI will be ar://... (Arweave), ipfs://... (IPFS), or undefined (on-chain only)
+
 // Prepare feedback (only score is mandatory)
 const feedbackFile = sdk.prepareFeedback(
   '11155111:123',
@@ -215,6 +219,7 @@ const feedbackFile = sdk.prepareFeedback(
 
 // Give feedback
 const feedback = await sdk.giveFeedback('11155111:123', feedbackFile);
+console.log(feedback.fileURI); // ar://... (Arweave), ipfs://... (IPFS), or undefined
 
 // Search feedback
 const feedbackResults = await sdk.searchFeedback(
@@ -411,6 +416,21 @@ The SDK includes complete OASF v0.8.0 taxonomy files:
 
 Browse these files to find appropriate skill and domain slugs. For more information, see the [OASF specification](https://github.com/agntcy/oasf) and [Release Notes v0.31](RELEASE_NOTES_0.31.md).
 
+## Arweave Storage Configuration
+
+```typescript
+// Arweave permanent storage
+const sdk = new SDK({
+  chainId: 11155111,
+  rpcUrl: '...',
+  signer: privateKey,
+  arweave: true,
+  arweavePrivateKey: 'your-arweave-private-key' // Optional (defaults to signer)
+});
+
+// Register with Arweave
+await agent.registerArweave();
+```
 ## 🚀 Coming Soon
 
 - Support for validations