@buildersgarden/siwa 0.0.16 → 0.0.17

package/README.md

@@ -64,7 +64,7 @@ See [`references/security-model.md`](references/security-model.md) for the full
 
 ## References
 
-- [SKILL.md](SKILL.md) — Full skill documentation and API reference
+- [skill.md](skill.md) — Full skill documentation and API reference
 - [ERC-8004 specification](https://github.com/builders-garden/ERC-8004)
 - [SIWA protocol spec](references/siwa-spec.md)
 

package/dist/registry.d.ts

@@ -7,7 +7,7 @@
  * Dependencies:
  *   npm install viem
  */
-import { type PublicClient } from 'viem';
+import { type PublicClient, type Address, type Hex } from 'viem';
 import type { TransactionSigner } from './signer/index.js';
 /** Service endpoint types defined in ERC-8004 */
 export type ServiceType = 'web' | 'A2A' | 'MCP' | 'OASF' | 'ENS' | 'DID' | 'email';
@@ -73,6 +73,45 @@ export declare function getAgent(agentId: number, options: GetAgentOptions): Pro
  * @param options  Reputation registry address, client, and optional filters
  */
 export declare function getReputation(agentId: number, options: GetReputationOptions): Promise<ReputationSummary>;
+export interface EncodeRegisterAgentOptions {
+    /** The agent metadata URI (IPFS, HTTP, or data URL) */
+    agentURI: string;
+    /** The chain ID to register on */
+    chainId: number;
+}
+export interface EncodeRegisterAgentResult {
+    /** The registry contract address */
+    to: Address;
+    /** The ABI-encoded calldata for `register(agentURI)` */
+    data: Hex;
+}
+/**
+ * Encode the calldata for an ERC-8004 agent registration without sending it.
+ *
+ * Use this when your wallet provider handles transaction submission separately
+ * (e.g. Bankr's `/agent/submit`, or any ERC-4337 bundler).
+ *
+ * @example
+ * ```typescript
+ * import { encodeRegisterAgent } from '@buildersgarden/siwa/registry';
+ *
+ * const { to, data } = encodeRegisterAgent({
+ *   agentURI: 'data:application/json;base64,...',
+ *   chainId: 84532,
+ * });
+ *
+ * // Submit via your provider (e.g. Bankr)
+ * await fetch('https://api.bankr.bot/agent/submit', {
+ *   method: 'POST',
+ *   headers: { 'Content-Type': 'application/json', 'X-API-Key': apiKey },
+ *   body: JSON.stringify({
+ *     transaction: { to, data, value: '0', chainId: 84532 },
+ *     waitForConfirmation: true,
+ *   }),
+ * });
+ * ```
+ */
+export declare function encodeRegisterAgent(options: EncodeRegisterAgentOptions): EncodeRegisterAgentResult;
 export interface RegisterAgentOptions {
     /** The agent metadata URI (IPFS, HTTP, or data URL) */
     agentURI: string;

package/dist/registry.js

@@ -156,6 +156,42 @@ export async function getReputation(agentId, options) {
     const score = Number(rawValue) / 10 ** decimals;
     return { count: Number(count), score, rawValue, decimals };
 }
+/**
+ * Encode the calldata for an ERC-8004 agent registration without sending it.
+ *
+ * Use this when your wallet provider handles transaction submission separately
+ * (e.g. Bankr's `/agent/submit`, or any ERC-4337 bundler).
+ *
+ * @example
+ * ```typescript
+ * import { encodeRegisterAgent } from '@buildersgarden/siwa/registry';
+ *
+ * const { to, data } = encodeRegisterAgent({
+ *   agentURI: 'data:application/json;base64,...',
+ *   chainId: 84532,
+ * });
+ *
+ * // Submit via your provider (e.g. Bankr)
+ * await fetch('https://api.bankr.bot/agent/submit', {
+ *   method: 'POST',
+ *   headers: { 'Content-Type': 'application/json', 'X-API-Key': apiKey },
+ *   body: JSON.stringify({
+ *     transaction: { to, data, value: '0', chainId: 84532 },
+ *     waitForConfirmation: true,
+ *   }),
+ * });
+ * ```
+ */
+export function encodeRegisterAgent(options) {
+    const { agentURI, chainId } = options;
+    const registryAddress = getRegistryAddress(chainId);
+    const data = encodeFunctionData({
+        abi: IDENTITY_REGISTRY_ABI,
+        functionName: 'register',
+        args: [agentURI],
+    });
+    return { to: registryAddress, data };
+}
 /**
  * Register an agent on the ERC-8004 Identity Registry in a single call.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildersgarden/siwa",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "type": "module",
   "exports": {
     ".": {