@waiaas/core 2.11.0-rc.7 → 2.11.0

package/README.md

@@ -133,7 +133,7 @@ waiaas quickset                  # Creates wallets + sessions automatically
 waiaas set-master                # (Later) Harden password, then delete recovery.key
 ```
 
-The `--auto-provision` flag generates a cryptographically random master password and saves it to `~/.waiaas/recovery.key`. All subsequent CLI commands read it automatically. See the [Agent Self-Setup Guide](docs/guides/agent-self-setup.md) for the complete flow.
+The `--auto-provision` flag generates a cryptographically random master password and saves it to `~/.waiaas/recovery.key`. All subsequent CLI commands read it automatically. See the [Agent Self-Setup Guide](docs/agent-guides/agent-self-setup.md) for the complete flow.
 
 For manual setup with human-guided password entry, install skills and follow `waiaas-setup/SKILL.md`:
 
@@ -215,10 +215,10 @@ Enabled by default (`admin_ui = true` in config.toml).
 | [Security Model](docs/security-model.md) | Authentication, policy engine, Kill Switch, AutoStop |
 | [Deployment Guide](docs/deployment.md) | Docker, npm, configuration reference |
 | [API Reference](docs/api-reference.md) | REST API endpoints and authentication |
-| [Agent Self-Setup Guide](docs/guides/agent-self-setup.md) | Fully autonomous setup with auto-provision |
-| [Agent Skills Integration](docs/guides/agent-skills-integration.md) | Universal guide for 27+ AI agent platforms |
-| [Claude Code Integration](docs/guides/claude-code-integration.md) | Skill files + MCP server setup for Claude Code |
-| [OpenClaw Integration](docs/guides/openclaw-integration.md) | Quick setup for OpenClaw bot |
+| [Agent Self-Setup Guide](docs/agent-guides/agent-self-setup.md) | Fully autonomous setup with auto-provision |
+| [Agent Skills Integration](docs/agent-guides/agent-skills-integration.md) | Universal guide for 27+ AI agent platforms |
+| [Claude Code Integration](docs/agent-guides/claude-code-integration.md) | Skill files + MCP server setup for Claude Code |
+| [OpenClaw Integration](docs/agent-guides/openclaw-integration.md) | Quick setup for OpenClaw bot |
 | [Wallet SDK Integration](docs/wallet-sdk-integration.md) | Integration guide for wallet developers |
 | [Why WAIaaS?](docs/why-waiaas/) | Background on AI agent wallet security |
 | [Contributing](CONTRIBUTING.md) | Development setup, code style, testing, PR guidelines |

package/dist/caip/asset-resolve.d.ts

@@ -0,0 +1,39 @@
+/**
+ * CAIP-19 asset ID parsing and network extraction utilities.
+ *
+ * parseAssetId: parses a CAIP-19 asset type string and resolves the WAIaaS network.
+ * extractNetworkFromAssetId: convenience wrapper that returns only the network.
+ *
+ * @see standards.chainagnostic.org/CAIPs/caip-19
+ */
+import type { NetworkType } from '../enums/chain.js';
+export interface ParsedAssetId {
+    /** CAIP-2 chain identifier (e.g., "eip155:1") */
+    chainId: string;
+    /** Asset namespace (e.g., "erc20", "token", "slip44") */
+    namespace: string;
+    /** Token address, or null for native assets (slip44) */
+    address: string | null;
+    /** Resolved WAIaaS network type */
+    network: NetworkType;
+    /** True if this is a native asset (slip44 namespace) */
+    isNative: boolean;
+}
+/**
+ * Parse a CAIP-19 asset type string into its components with WAIaaS network resolution.
+ *
+ * - slip44 namespace => isNative=true, address=null
+ * - erc20/token namespace => isNative=false, address=assetReference
+ *
+ * @throws {Error} if CAIP-19 format is invalid
+ * @throws {Error} if CAIP-2 chain ID is not in the network mapping
+ */
+export declare function parseAssetId(assetId: string): ParsedAssetId;
+/**
+ * Extract the WAIaaS network type from a CAIP-19 asset type string.
+ * Convenience wrapper around parseAssetId.
+ *
+ * @throws {Error} if CAIP-19 format is invalid or CAIP-2 chain ID is unknown
+ */
+export declare function extractNetworkFromAssetId(assetId: string): NetworkType;
+//# sourceMappingURL=asset-resolve.d.ts.map

package/dist/caip/asset-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-resolve.d.ts","sourceRoot":"","sources":["../../src/caip/asset-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mCAAmC;IACnC,OAAO,EAAE,WAAW,CAAC;IACrB,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAa3D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAEtE"}

package/dist/caip/asset-resolve.js

@@ -0,0 +1,33 @@
+import { parseCaip19 } from './caip19.js';
+import { caip2ToNetwork } from './network-map.js';
+/**
+ * Parse a CAIP-19 asset type string into its components with WAIaaS network resolution.
+ *
+ * - slip44 namespace => isNative=true, address=null
+ * - erc20/token namespace => isNative=false, address=assetReference
+ *
+ * @throws {Error} if CAIP-19 format is invalid
+ * @throws {Error} if CAIP-2 chain ID is not in the network mapping
+ */
+export function parseAssetId(assetId) {
+    const parsed = parseCaip19(assetId);
+    const { network } = caip2ToNetwork(parsed.chainId);
+    const isNative = parsed.assetNamespace === 'slip44';
+    return {
+        chainId: parsed.chainId,
+        namespace: parsed.assetNamespace,
+        address: isNative ? null : parsed.assetReference,
+        network,
+        isNative,
+    };
+}
+/**
+ * Extract the WAIaaS network type from a CAIP-19 asset type string.
+ * Convenience wrapper around parseAssetId.
+ *
+ * @throws {Error} if CAIP-19 format is invalid or CAIP-2 chain ID is unknown
+ */
+export function extractNetworkFromAssetId(assetId) {
+    return parseAssetId(assetId).network;
+}
+//# sourceMappingURL=asset-resolve.js.map

package/dist/caip/asset-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-resolve.js","sourceRoot":"","sources":["../../src/caip/asset-resolve.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAelD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,KAAK,QAAQ,CAAC;IAEpD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,cAAc;QAChC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc;QAChD,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;AACvC,CAAC"}

package/dist/caip/index.d.ts

@@ -2,4 +2,6 @@ export { Caip2Schema, type Caip2, type Caip2Params, parseCaip2, formatCaip2 } fr
 export { CAIP19_REGEX, Caip19AssetTypeSchema, Caip19Schema, type Caip19AssetType, type Caip19, type Caip19Params, parseCaip19, formatCaip19, } from './caip19.js';
 export { CAIP2_TO_NETWORK, NETWORK_TO_CAIP2, networkToCaip2, caip2ToNetwork } from './network-map.js';
 export { nativeAssetId, tokenAssetId, isNativeAsset, nftAssetId, isNftAsset } from './asset-helpers.js';
+export { parseAssetId, extractNetworkFromAssetId, type ParsedAssetId } from './asset-resolve.js';
+export { enrichBalance, enrichAsset, enrichNft, enrichTransaction, enrichIncomingTx } from './response-enrichment.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/caip/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/caip/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGhG,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGtG,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/caip/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGhG,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGtG,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGxG,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGjG,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/caip/index.js

@@ -6,4 +6,8 @@ export { CAIP19_REGEX, Caip19AssetTypeSchema, Caip19Schema, parseCaip19, formatC
 export { CAIP2_TO_NETWORK, NETWORK_TO_CAIP2, networkToCaip2, caip2ToNetwork } from './network-map.js';
 // Asset helpers (native + token + NFT CAIP-19 generation)
 export { nativeAssetId, tokenAssetId, isNativeAsset, nftAssetId, isNftAsset } from './asset-helpers.js';
+// Asset resolve (CAIP-19 parsing + network extraction)
+export { parseAssetId, extractNetworkFromAssetId } from './asset-resolve.js';
+// Response enrichment (runtime CAIP-2/19 injection)
+export { enrichBalance, enrichAsset, enrichNft, enrichTransaction, enrichIncomingTx } from './response-enrichment.js';
 //# sourceMappingURL=index.js.map

package/dist/caip/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/caip/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAgC,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhG,uBAAuB;AACvB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,YAAY,EAIZ,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,qDAAqD;AACrD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEtG,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/caip/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAgC,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhG,uBAAuB;AACvB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,YAAY,EAIZ,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,qDAAqD;AACrD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEtG,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAExG,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAsB,MAAM,oBAAoB,CAAC;AAEjG,oDAAoD;AACpD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/caip/response-enrichment.d.ts

@@ -0,0 +1,70 @@
+/**
+ * CAIP response enrichment utilities.
+ *
+ * Each function takes an existing response object and returns a new object
+ * with chainId (CAIP-2) and/or assetId (CAIP-19) fields added.
+ *
+ * All functions are:
+ * - Additive only: original fields are spread and never removed
+ * - Graceful: unknown networks produce no chainId/assetId (no errors thrown)
+ *
+ * @see Phase 409-01 -- response enrichment utility functions
+ */
+/**
+ * Enrich a balance response with chainId and native assetId.
+ */
+export declare function enrichBalance<T extends Record<string, unknown>>(obj: T & {
+    network: string;
+}): T & {
+    chainId?: string;
+    assetId?: string;
+};
+/**
+ * Enrich an asset response with chainId and assetId.
+ * - isNative=true -> slip44 namespace
+ * - isNative=false -> erc20 (EVM) or token (Solana) namespace
+ */
+export declare function enrichAsset<T extends Record<string, unknown>>(obj: T & {
+    network: string;
+    mint: string;
+    isNative: boolean;
+}): T & {
+    chainId?: string;
+    assetId?: string;
+};
+/**
+ * Enrich an NFT response with chainId and assetId.
+ * Only generates assetId for known standards (erc721, erc1155, metaplex).
+ */
+export declare function enrichNft<T extends Record<string, unknown>>(obj: T & {
+    network: string;
+    contractAddress: string;
+    tokenId: string;
+    standard: string;
+}): T & {
+    chainId?: string;
+    assetId?: string;
+};
+/**
+ * Enrich a transaction response with chainId.
+ * Only adds chainId when network is present and non-null.
+ */
+export declare function enrichTransaction<T extends Record<string, unknown>>(obj: T & {
+    network?: string | null;
+}): T & {
+    chainId?: string;
+};
+/**
+ * Enrich an incoming transaction response with chainId and assetId.
+ * - tokenAddress null/undefined -> native assetId
+ * - tokenAddress present -> token assetId (erc20/token namespace)
+ */
+export declare function enrichIncomingTx<T extends Record<string, unknown>>(obj: T & {
+    network: string;
+    chain: string;
+    tokenAddress?: string | null;
+}): T & {
+    chainId?: string;
+    assetId?: string;
+};
+//# sourceMappingURL=response-enrichment.d.ts.map

package/dist/caip/response-enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-enrichment.d.ts","sourceRoot":"","sources":["../../src/caip/response-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqCH;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,GAAG,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3B,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAQ5C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,GAAG,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC5D,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAe5C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,GAAG,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvF,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAuB5C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,GAAG,EAAE,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACnC,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAS1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,GAAG,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxE,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAe5C"}

package/dist/caip/response-enrichment.js

@@ -0,0 +1,132 @@
+/**
+ * CAIP response enrichment utilities.
+ *
+ * Each function takes an existing response object and returns a new object
+ * with chainId (CAIP-2) and/or assetId (CAIP-19) fields added.
+ *
+ * All functions are:
+ * - Additive only: original fields are spread and never removed
+ * - Graceful: unknown networks produce no chainId/assetId (no errors thrown)
+ *
+ * @see Phase 409-01 -- response enrichment utility functions
+ */
+import { networkToCaip2 } from './network-map.js';
+import { nativeAssetId, tokenAssetId, nftAssetId } from './asset-helpers.js';
+// ── Helpers ──────────────────────────────────────────────────────────
+/** Safely get CAIP-2 chain ID from network string. Returns undefined on failure. */
+function safeChainId(network) {
+    try {
+        return networkToCaip2(network);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Safely get native CAIP-19 asset ID. Returns undefined on failure. */
+function safeNativeAssetId(network) {
+    try {
+        return nativeAssetId(network);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Safely get token CAIP-19 asset ID. Returns undefined on failure. */
+function safeTokenAssetId(network, address) {
+    try {
+        return tokenAssetId(network, address);
+    }
+    catch {
+        return undefined;
+    }
+}
+// ── Enrichment functions ─────────────────────────────────────────────
+/**
+ * Enrich a balance response with chainId and native assetId.
+ */
+export function enrichBalance(obj) {
+    const chainId = safeChainId(obj.network);
+    const assetId = safeNativeAssetId(obj.network);
+    return {
+        ...obj,
+        ...(chainId ? { chainId } : {}),
+        ...(assetId ? { assetId } : {}),
+    };
+}
+/**
+ * Enrich an asset response with chainId and assetId.
+ * - isNative=true -> slip44 namespace
+ * - isNative=false -> erc20 (EVM) or token (Solana) namespace
+ */
+export function enrichAsset(obj) {
+    const chainId = safeChainId(obj.network);
+    let assetId;
+    if (obj.isNative) {
+        assetId = safeNativeAssetId(obj.network);
+    }
+    else {
+        assetId = safeTokenAssetId(obj.network, obj.mint);
+    }
+    return {
+        ...obj,
+        ...(chainId ? { chainId } : {}),
+        ...(assetId ? { assetId } : {}),
+    };
+}
+/**
+ * Enrich an NFT response with chainId and assetId.
+ * Only generates assetId for known standards (erc721, erc1155, metaplex).
+ */
+export function enrichNft(obj) {
+    const chainId = safeChainId(obj.network);
+    let assetId;
+    const validStandards = new Set(['erc721', 'erc1155', 'metaplex']);
+    if (validStandards.has(obj.standard)) {
+        try {
+            assetId = nftAssetId(obj.network, obj.contractAddress, obj.tokenId, obj.standard);
+        }
+        catch {
+            // graceful skip
+        }
+    }
+    return {
+        ...obj,
+        ...(chainId ? { chainId } : {}),
+        ...(assetId ? { assetId } : {}),
+    };
+}
+/**
+ * Enrich a transaction response with chainId.
+ * Only adds chainId when network is present and non-null.
+ */
+export function enrichTransaction(obj) {
+    if (!obj.network) {
+        return { ...obj };
+    }
+    const chainId = safeChainId(obj.network);
+    return {
+        ...obj,
+        ...(chainId ? { chainId } : {}),
+    };
+}
+/**
+ * Enrich an incoming transaction response with chainId and assetId.
+ * - tokenAddress null/undefined -> native assetId
+ * - tokenAddress present -> token assetId (erc20/token namespace)
+ */
+export function enrichIncomingTx(obj) {
+    const chainId = safeChainId(obj.network);
+    let assetId;
+    if (obj.tokenAddress) {
+        assetId = safeTokenAssetId(obj.network, obj.tokenAddress);
+    }
+    else {
+        assetId = safeNativeAssetId(obj.network);
+    }
+    return {
+        ...obj,
+        ...(chainId ? { chainId } : {}),
+        ...(assetId ? { assetId } : {}),
+    };
+}
+//# sourceMappingURL=response-enrichment.js.map

package/dist/caip/response-enrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-enrichment.js","sourceRoot":"","sources":["../../src/caip/response-enrichment.ts"],"names":[],"mappings":"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"}

package/dist/constants/index.d.ts

@@ -1,2 +1,3 @@
 export { AA_PROVIDER_CHAIN_MAP, resolveProviderChainId, buildProviderBundlerUrl, AA_PROVIDER_DASHBOARD_URLS, } from './aa-provider-chains.js';
+export { WELL_KNOWN_CONTRACTS, type WellKnownContractEntry, } from './well-known-contracts.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,2BAA2B,CAAC"}

package/dist/constants/index.js

@@ -1,2 +1,4 @@
 export { AA_PROVIDER_CHAIN_MAP, resolveProviderChainId, buildProviderBundlerUrl, AA_PROVIDER_DASHBOARD_URLS, } from './aa-provider-chains.js';
+// v32.0 Well-known contract data
+export { WELL_KNOWN_CONTRACTS, } from './well-known-contracts.js';
 //# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AAEjC,iCAAiC;AACjC,OAAO,EACL,oBAAoB,GAErB,MAAM,2BAA2B,CAAC"}

package/dist/constants/well-known-contracts.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Well-known contract addresses for human-readable name resolution.
+ *
+ * 300+ entries across 6 networks (Ethereum, Base, Arbitrum, Optimism, Polygon, Solana).
+ * Used by ContractNameRegistry as Tier 2 (well-known) data source.
+ *
+ * All EVM addresses MUST be lowercase (no checksummed mixed-case).
+ * Solana addresses are base58 strings.
+ */
+/** A single well-known contract entry. */
+export interface WellKnownContractEntry {
+    /** Contract address (lowercase hex for EVM, base58 for Solana). */
+    address: string;
+    /** Human-readable name. */
+    name: string;
+    /** Protocol or project name. */
+    protocol: string;
+    /** Network identifier. */
+    network: string;
+}
+export declare const WELL_KNOWN_CONTRACTS: readonly WellKnownContractEntry[];
+//# sourceMappingURL=well-known-contracts.d.ts.map

package/dist/constants/well-known-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known-contracts.d.ts","sourceRoot":"","sources":["../../src/constants/well-known-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,oBAAoB,EAAE,SAAS,sBAAsB,EAsexD,CAAC"}