envoy-pay 0.1.0

package/dist/esm/identity/erc8004/abis.js

@@ -0,0 +1,215 @@
+/**
+ * Minimal ABI fragments for the canonical ERC-8004 contracts on Celo.
+ *
+ * Sourced from the upstream Solidity at:
+ *   https://github.com/erc-8004/erc-8004-contracts/blob/main/contracts/
+ *
+ * We deliberately do NOT vendor the full ABI — only the function and event
+ * signatures the SDK touches. If you need a method that's not here, add it
+ * (it's an additive change) rather than swapping in the full upstream ABI.
+ *
+ * Marked `as const` so viem can infer return types from the ABI shape.
+ */
+export const ERC8004_IDENTITY_ABI = [
+    // ---- writes ----
+    {
+        type: 'function',
+        name: 'register',
+        stateMutability: 'nonpayable',
+        inputs: [],
+        outputs: [{ name: 'agentId', type: 'uint256' }],
+    },
+    {
+        type: 'function',
+        name: 'register',
+        stateMutability: 'nonpayable',
+        inputs: [{ name: 'agentURI', type: 'string' }],
+        outputs: [{ name: 'agentId', type: 'uint256' }],
+    },
+    {
+        type: 'function',
+        name: 'register',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentURI', type: 'string' },
+            {
+                name: 'metadata',
+                type: 'tuple[]',
+                components: [
+                    { name: 'metadataKey', type: 'string' },
+                    { name: 'metadataValue', type: 'bytes' },
+                ],
+            },
+        ],
+        outputs: [{ name: 'agentId', type: 'uint256' }],
+    },
+    {
+        type: 'function',
+        name: 'setAgentURI',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'newURI', type: 'string' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'setMetadata',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'metadataKey', type: 'string' },
+            { name: 'metadataValue', type: 'bytes' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'setAgentWallet',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'newWallet', type: 'address' },
+            { name: 'deadline', type: 'uint256' },
+            { name: 'signature', type: 'bytes' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'unsetAgentWallet',
+        stateMutability: 'nonpayable',
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        outputs: [],
+    },
+    // ---- reads ----
+    {
+        type: 'function',
+        name: 'getAgentWallet',
+        stateMutability: 'view',
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        outputs: [{ name: '', type: 'address' }],
+    },
+    {
+        type: 'function',
+        name: 'getMetadata',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'metadataKey', type: 'string' },
+        ],
+        outputs: [{ name: '', type: 'bytes' }],
+    },
+    {
+        type: 'function',
+        name: 'isAuthorizedOrOwner',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'spender', type: 'address' },
+            { name: 'agentId', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    // ---- ERC-721 surface we use ----
+    {
+        type: 'function',
+        name: 'ownerOf',
+        stateMutability: 'view',
+        inputs: [{ name: 'tokenId', type: 'uint256' }],
+        outputs: [{ name: '', type: 'address' }],
+    },
+    {
+        type: 'function',
+        name: 'tokenURI',
+        stateMutability: 'view',
+        inputs: [{ name: 'tokenId', type: 'uint256' }],
+        outputs: [{ name: '', type: 'string' }],
+    },
+    // ---- events ----
+    {
+        type: 'event',
+        name: 'Registered',
+        inputs: [
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'agentURI', type: 'string', indexed: false },
+            { name: 'owner', type: 'address', indexed: true },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'URIUpdated',
+        inputs: [
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'newURI', type: 'string', indexed: false },
+            { name: 'updatedBy', type: 'address', indexed: true },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'MetadataSet',
+        inputs: [
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'indexedMetadataKey', type: 'string', indexed: true },
+            { name: 'metadataKey', type: 'string', indexed: false },
+            { name: 'metadataValue', type: 'bytes', indexed: false },
+        ],
+    },
+];
+export const ERC8004_REPUTATION_ABI = [
+    // ---- writes ----
+    {
+        type: 'function',
+        name: 'giveFeedback',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'value', type: 'int128' },
+            { name: 'valueDecimals', type: 'uint8' },
+            { name: 'tag1', type: 'string' },
+            { name: 'tag2', type: 'string' },
+            { name: 'endpoint', type: 'string' },
+            { name: 'feedbackURI', type: 'string' },
+            { name: 'feedbackHash', type: 'bytes32' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'revokeFeedback',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'feedbackIndex', type: 'uint64' },
+        ],
+        outputs: [],
+    },
+    // ---- events ----
+    {
+        type: 'event',
+        name: 'NewFeedback',
+        inputs: [
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'clientAddress', type: 'address', indexed: true },
+            { name: 'feedbackIndex', type: 'uint64', indexed: false },
+            { name: 'value', type: 'int128', indexed: false },
+            { name: 'valueDecimals', type: 'uint8', indexed: false },
+            { name: 'indexedTag1', type: 'string', indexed: true },
+            { name: 'tag1', type: 'string', indexed: false },
+            { name: 'tag2', type: 'string', indexed: false },
+            { name: 'endpoint', type: 'string', indexed: false },
+            { name: 'feedbackURI', type: 'string', indexed: false },
+            { name: 'feedbackHash', type: 'bytes32', indexed: false },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'FeedbackRevoked',
+        inputs: [
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'clientAddress', type: 'address', indexed: true },
+            { name: 'feedbackIndex', type: 'uint64', indexed: true },
+        ],
+    },
+];
+//# sourceMappingURL=abis.js.map

package/dist/esm/identity/erc8004/abis.js.map

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

package/dist/esm/identity/erc8004/identity.js

@@ -0,0 +1,250 @@
+/**
+ * Helpers around the canonical Celo ERC-8004 Identity Registry.
+ *
+ * The Identity Registry is the source of truth for who an agent is:
+ *
+ *   - Registration mints an ERC-721 NFT to `msg.sender`. The tokenId is the
+ *     agentId we use everywhere else.
+ *   - `getAgentWallet(agentId)` returns the address authorized to *sign on the
+ *     agent's behalf* — separate from `ownerOf(agentId)` which holds the NFT.
+ *   - On NFT transfer the canonical contract clears `agentWallet`, so the new
+ *     holder must re-register their signing wallet (via `setAgentWallet`).
+ *
+ * All helpers take a viem `Client` and the canonical Identity Registry
+ * `address` for the chain you're targeting. Pull the address from
+ * `getEnvoyAddresses(chainId).identityRegistry`.
+ */
+import { decodeEventLog, encodePacked, getAddress, hexToBytes, keccak256, stringToHex, toHex, } from 'viem';
+import { ERC8004_IDENTITY_ABI } from './abis.js';
+/**
+ * Register a new agent on the canonical Identity Registry. The caller's address
+ * becomes the NFT owner AND the initial `agentWallet`. Returns the minted
+ * `agentId` (parsed from the `Registered` event in the receipt).
+ *
+ * Three overloads are exposed on the contract; this helper picks the one whose
+ * input shape matches the arguments you pass (no URI / URI only / URI + metadata).
+ */
+export async function registerAgent(walletClient, publicClient, registryAddress, args = {}) {
+    const account = walletClient.account;
+    if (!account)
+        throw new Error('registerAgent: walletClient has no account configured');
+    let txHash;
+    if (args.metadata && args.metadata.length > 0) {
+        txHash = await walletClient.writeContract({
+            address: registryAddress,
+            abi: ERC8004_IDENTITY_ABI,
+            functionName: 'register',
+            args: [
+                args.agentURI ?? '',
+                args.metadata.map((m) => ({ metadataKey: m.key, metadataValue: m.value })),
+            ],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    else if (args.agentURI !== undefined) {
+        txHash = await walletClient.writeContract({
+            address: registryAddress,
+            abi: ERC8004_IDENTITY_ABI,
+            functionName: 'register',
+            args: [args.agentURI],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    else {
+        txHash = await walletClient.writeContract({
+            address: registryAddress,
+            abi: ERC8004_IDENTITY_ABI,
+            functionName: 'register',
+            args: [],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    for (const log of receipt.logs) {
+        if (getAddress(log.address) !== getAddress(registryAddress))
+            continue;
+        try {
+            const decoded = decodeEventLog({
+                abi: ERC8004_IDENTITY_ABI,
+                data: log.data,
+                topics: log.topics,
+            });
+            if (decoded.eventName === 'Registered') {
+                return { agentId: decoded.args.agentId, txHash };
+            }
+        }
+        catch {
+            // Not the event we wanted — keep scanning.
+        }
+    }
+    throw new Error(`registerAgent: no Registered event found in receipt ${txHash}; ` +
+        'the transaction succeeded but the agentId could not be parsed.');
+}
+/**
+ * Rotate the agent's operational signing wallet. The new wallet (or its owner, in
+ * the ERC-1271 case) must produce a signature over the EIP-712 `AgentWalletSet`
+ * struct: `(uint256 agentId, address newWallet, address owner, uint256 deadline)`.
+ *
+ * The canonical contract verifies both ECDSA (EOA / 7702) and ERC-1271 paths.
+ * Build the signature off-chain with `signAgentWalletRotation` below.
+ */
+export async function setAgentWallet(walletClient, registryAddress, args) {
+    const account = walletClient.account;
+    if (!account)
+        throw new Error('setAgentWallet: walletClient has no account configured');
+    return walletClient.writeContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'setAgentWallet',
+        args: [args.agentId, args.newWallet, args.deadline, args.signature],
+        account,
+        chain: walletClient.chain,
+    });
+}
+/** Clear the agent's operational signing wallet. Effectively pauses on-chain payments. */
+export async function unsetAgentWallet(walletClient, registryAddress, agentId) {
+    const account = walletClient.account;
+    if (!account)
+        throw new Error('unsetAgentWallet: walletClient has no account configured');
+    return walletClient.writeContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'unsetAgentWallet',
+        args: [agentId],
+        account,
+        chain: walletClient.chain,
+    });
+}
+/** Update the agent's URI (e.g. when the agent card moves IPFS gateways). */
+export async function setAgentURI(walletClient, registryAddress, agentId, newURI) {
+    const account = walletClient.account;
+    if (!account)
+        throw new Error('setAgentURI: walletClient has no account configured');
+    return walletClient.writeContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'setAgentURI',
+        args: [agentId, newURI],
+        account,
+        chain: walletClient.chain,
+    });
+}
+/** Set a single metadata key/value pair. Reserved key `"agentWallet"` is rejected on-chain. */
+export async function setMetadata(walletClient, registryAddress, agentId, key, value) {
+    const account = walletClient.account;
+    if (!account)
+        throw new Error('setMetadata: walletClient has no account configured');
+    return walletClient.writeContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'setMetadata',
+        args: [agentId, key, value],
+        account,
+        chain: walletClient.chain,
+    });
+}
+// ---------------------------------------------------------------------------
+// Reads
+// ---------------------------------------------------------------------------
+export async function getAgentWallet(publicClient, registryAddress, agentId) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'getAgentWallet',
+        args: [agentId],
+    });
+}
+export async function getAgentOwner(publicClient, registryAddress, agentId) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'ownerOf',
+        args: [agentId],
+    });
+}
+export async function getAgentURI(publicClient, registryAddress, agentId) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'tokenURI',
+        args: [agentId],
+    });
+}
+export async function getMetadata(publicClient, registryAddress, agentId, key) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'getMetadata',
+        args: [agentId, key],
+    });
+}
+export async function isAuthorizedOrOwner(publicClient, registryAddress, spender, agentId) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: ERC8004_IDENTITY_ABI,
+        functionName: 'isAuthorizedOrOwner',
+        args: [spender, agentId],
+    });
+}
+/** Aggregate read — one round-trip per field. Convenience wrapper. */
+export async function getAgent(publicClient, registryAddress, agentId) {
+    const [owner, agentWallet, tokenURI] = await Promise.all([
+        getAgentOwner(publicClient, registryAddress, agentId),
+        getAgentWallet(publicClient, registryAddress, agentId),
+        getAgentURI(publicClient, registryAddress, agentId).catch(() => ''),
+    ]);
+    return { agentId, owner, agentWallet, tokenURI };
+}
+// ---------------------------------------------------------------------------
+// EIP-712 helpers for setAgentWallet
+// ---------------------------------------------------------------------------
+/**
+ * EIP-712 typed-data payload the new wallet must sign before `setAgentWallet`
+ * can be called. The canonical contract's domain is
+ * `EIP712Domain("ERC8004IdentityRegistry","1",chainId,verifyingContract)`.
+ *
+ * Pass the result to `walletClient.signTypedData(...)` from the *new* wallet (or
+ * its ERC-1271 owner), then pass the signature into `setAgentWallet`.
+ */
+export function agentWalletRotationTypedData(args) {
+    return {
+        domain: {
+            name: 'ERC8004IdentityRegistry',
+            version: '1',
+            chainId: args.chainId,
+            verifyingContract: args.registryAddress,
+        },
+        types: {
+            AgentWalletSet: [
+                { name: 'agentId', type: 'uint256' },
+                { name: 'newWallet', type: 'address' },
+                { name: 'owner', type: 'address' },
+                { name: 'deadline', type: 'uint256' },
+            ],
+        },
+        primaryType: 'AgentWalletSet',
+        message: {
+            agentId: args.agentId,
+            newWallet: args.newWallet,
+            owner: args.owner,
+            deadline: args.deadline,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Encoding helpers
+// ---------------------------------------------------------------------------
+/** Encode a UTF-8 string as a metadata value. Use for `setMetadata(...)`. */
+export const encodeStringMetadata = (s) => stringToHex(s);
+/** Encode raw bytes as a metadata value. */
+export const encodeBytesMetadata = (b) => toHex(b);
+/** Compute the keccak256 hash an agent card URI's contents would have. Useful for `feedbackHash` etc. */
+export function contentHash(bytes) {
+    return keccak256(bytes);
+}
+/** Re-export viem encoder so callers don't have to import viem directly for trivial work. */
+export { encodePacked, hexToBytes };
+//# sourceMappingURL=identity.js.map

package/dist/esm/identity/erc8004/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../src/identity/erc8004/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAML,cAAc,EACd,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,KAAK,GACN,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAc9C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,YAA0B,EAC1B,YAA0B,EAC1B,eAAwB,EACxB,OAA0B,EAAE;IAE5B,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAEvF,IAAI,MAAY,CAAC;IACjB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;YACxC,OAAO,EAAE,eAAe;YACxB,GAAG,EAAE,oBAAoB;YACzB,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE;gBACJ,IAAI,CAAC,QAAQ,IAAI,EAAE;gBACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;aAC3E;YACD,OAAO;YACP,KAAK,EAAE,YAAY,CAAC,KAAK;SAC1B,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;YACxC,OAAO,EAAE,eAAe;YACxB,GAAG,EAAE,oBAAoB;YACzB,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;YACrB,OAAO;YACP,KAAK,EAAE,YAAY,CAAC,KAAK;SAC1B,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;YACxC,OAAO,EAAE,eAAe;YACxB,GAAG,EAAE,oBAAoB;YACzB,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,EAAE;YACR,OAAO;YACP,KAAK,EAAE,YAAY,CAAC,KAAK;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC,eAAe,CAAC;YAAE,SAAS;QACtE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,cAAc,CAAC;gBAC7B,GAAG,EAAE,oBAAoB;gBACzB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;gBACvC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACnD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,uDAAuD,MAAM,IAAI;QAC/D,gEAAgE,CACnE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAA0B,EAC1B,eAAwB,EACxB,IAAgF;IAEhF,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAExF,OAAO,YAAY,CAAC,aAAa,CAAC;QAChC,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,gBAAgB;QAC9B,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC;QACnE,OAAO;QACP,KAAK,EAAE,YAAY,CAAC,KAAK;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAA0B,EAC1B,eAAwB,EACxB,OAAgB;IAEhB,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAE1F,OAAO,YAAY,CAAC,aAAa,CAAC;QAChC,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,kBAAkB;QAChC,IAAI,EAAE,CAAC,OAAO,CAAC;QACf,OAAO;QACP,KAAK,EAAE,YAAY,CAAC,KAAK;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,YAA0B,EAC1B,eAAwB,EACxB,OAAgB,EAChB,MAAc;IAEd,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAErF,OAAO,YAAY,CAAC,aAAa,CAAC;QAChC,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,aAAa;QAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;QACvB,OAAO;QACP,KAAK,EAAE,YAAY,CAAC,KAAK;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,YAA0B,EAC1B,eAAwB,EACxB,OAAgB,EAChB,GAAW,EACX,KAAU;IAEV,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAErF,OAAO,YAAY,CAAC,aAAa,CAAC;QAChC,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,aAAa;QAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC;QAC3B,OAAO;QACP,KAAK,EAAE,YAAY,CAAC,KAAK;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAA0B,EAC1B,eAAwB,EACxB,OAAgB;IAEhB,OAAO,YAAY,CAAC,YAAY,CAAC;QAC/B,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,gBAAgB;QAC9B,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,YAA0B,EAC1B,eAAwB,EACxB,OAAgB;IAEhB,OAAO,YAAY,CAAC,YAAY,CAAC;QAC/B,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,YAA0B,EAC1B,eAAwB,EACxB,OAAgB;IAEhB,OAAO,YAAY,CAAC,YAAY,CAAC;QAC/B,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,UAAU;QACxB,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,YAA0B,EAC1B,eAAwB,EACxB,OAAgB,EAChB,GAAW;IAEX,OAAO,YAAY,CAAC,YAAY,CAAC;QAC/B,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,aAAa;QAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAA0B,EAC1B,eAAwB,EACxB,OAAgB,EAChB,OAAgB;IAEhB,OAAO,YAAY,CAAC,YAAY,CAAC;QAC/B,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,qBAAqB;QACnC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;KACzB,CAAC,CAAC;AACL,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,YAA0B,EAC1B,eAAwB,EACxB,OAAgB;IAEhB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,aAAa,CAAC,YAAY,EAAE,eAAe,EAAE,OAAO,CAAC;QACrD,cAAc,CAAC,YAAY,EAAE,eAAe,EAAE,OAAO,CAAC;QACtD,WAAW,CAAC,YAAY,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;KACpE,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAQ5C;IACC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,eAAe;SACxC;QACD,KAAK,EAAE;YACL,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;gBACpC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;gBACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;gBAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;aACtC;SACF;QACD,WAAW,EAAE,gBAAyB;QACtC,OAAO,EAAE;YACP,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAS,EAAO,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAEvE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAa,EAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEpE,yGAAyG;AACzG,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,6FAA6F;AAC7F,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/esm/identity/erc8004/index.js

@@ -0,0 +1,13 @@
+/**
+ * Canonical Celo ERC-8004 helpers — Identity + Reputation registries.
+ *
+ * These wrap the read/write surface envoy needs from the canonical contracts
+ * deployed on Celo (mainnet + Sepolia). All helpers are pure functions taking
+ * a viem client; no global state, no hidden singletons.
+ *
+ * Pull the registry addresses from `getEnvoyAddresses(chainId)`.
+ */
+export { registerAgent, setAgentWallet, unsetAgentWallet, setAgentURI, setMetadata, getAgentWallet, getAgentOwner, getAgentURI, getMetadata, isAuthorizedOrOwner, getAgent, agentWalletRotationTypedData, encodeStringMetadata, encodeBytesMetadata, contentHash, } from './identity.js';
+export { giveFeedback, revokeFeedback, makeScoreFeedback } from './reputation.js';
+export { ERC8004_IDENTITY_ABI, ERC8004_REPUTATION_ABI } from './abis.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/identity/erc8004/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/identity/erc8004/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,QAAQ,EACR,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE/E,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/esm/identity/erc8004/reputation.js

@@ -0,0 +1,105 @@
+/**
+ * Helpers around the canonical Celo ERC-8004 Reputation Registry.
+ *
+ * Each `giveFeedback` call attaches a signed value (with explicit decimals),
+ * two free-form tags, an endpoint string, and an optional URI+hash of a richer
+ * feedback document. The canonical contract:
+ *
+ *   - REJECTS self-feedback (where `msg.sender` is the agent's owner or an
+ *     approved operator) — see the source's `isAuthorizedOrOwner` check.
+ *   - Indexes feedback by `(agentId, clientAddress, feedbackIndex)`. The index
+ *     is 1-based per client; the first call returns 1, the second returns 2, etc.
+ *
+ * 8004scan reads these contracts directly, so any feedback attributed to your
+ * agentId here counts toward the Celo hackathon's Track 3 rank.
+ */
+import { decodeEventLog, getAddress, } from 'viem';
+import { ERC8004_REPUTATION_ABI } from './abis.js';
+/**
+ * Submit feedback on an agent. Returns the `feedbackIndex` (1-based per caller)
+ * parsed from the `NewFeedback` event in the receipt.
+ *
+ * The caller (`walletClient.account.address`) must NOT be authorized for the
+ * agent — i.e. an agent cannot rate itself. The contract reverts with
+ * "Self-feedback not allowed" if you try.
+ */
+export async function giveFeedback(walletClient, publicClient, registryAddress, args) {
+    const account = walletClient.account;
+    if (!account)
+        throw new Error('giveFeedback: walletClient has no account configured');
+    const txHash = await walletClient.writeContract({
+        address: registryAddress,
+        abi: ERC8004_REPUTATION_ABI,
+        functionName: 'giveFeedback',
+        args: [
+            args.agentId,
+            args.value,
+            args.valueDecimals,
+            args.tag1,
+            args.tag2,
+            args.endpoint,
+            args.feedbackURI,
+            args.feedbackHash,
+        ],
+        account,
+        chain: walletClient.chain,
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    for (const log of receipt.logs) {
+        if (getAddress(log.address) !== getAddress(registryAddress))
+            continue;
+        try {
+            const decoded = decodeEventLog({
+                abi: ERC8004_REPUTATION_ABI,
+                data: log.data,
+                topics: log.topics,
+            });
+            if (decoded.eventName === 'NewFeedback') {
+                return { feedbackIndex: BigInt(decoded.args.feedbackIndex), txHash };
+            }
+        }
+        catch {
+            // Different event — keep scanning.
+        }
+    }
+    throw new Error(`giveFeedback: no NewFeedback event in receipt ${txHash}`);
+}
+/**
+ * Revoke a previously-submitted feedback. Only the original `clientAddress`
+ * (i.e. the same wallet that called `giveFeedback`) can revoke.
+ */
+export async function revokeFeedback(walletClient, registryAddress, agentId, feedbackIndex) {
+    const account = walletClient.account;
+    if (!account)
+        throw new Error('revokeFeedback: walletClient has no account configured');
+    return walletClient.writeContract({
+        address: registryAddress,
+        abi: ERC8004_REPUTATION_ABI,
+        functionName: 'revokeFeedback',
+        args: [agentId, feedbackIndex],
+        account,
+        chain: walletClient.chain,
+    });
+}
+/**
+ * Build a `FeedbackArgs` object with the most common shape:
+ *   - a percentage-style score in [0, 100] with one decimal,
+ *   - two tags (category, sub-category),
+ *   - an endpoint string for which deployment the feedback applies to.
+ *
+ * `value=850, valueDecimals=1` means "85.0 / 100".
+ */
+export function makeScoreFeedback(args) {
+    const value = BigInt(Math.round(args.scoreOutOf100 * 10));
+    return {
+        agentId: args.agentId,
+        value,
+        valueDecimals: 1,
+        tag1: args.tag1,
+        tag2: args.tag2,
+        endpoint: args.endpoint,
+        feedbackURI: args.feedbackURI ?? '',
+        feedbackHash: args.feedbackHash ?? '0x0000000000000000000000000000000000000000000000000000000000000000',
+    };
+}
+//# sourceMappingURL=reputation.js.map

package/dist/esm/identity/erc8004/reputation.js.map

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

package/dist/esm/identity/erc8004/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/identity/erc8004/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/identity/erc8004/types.ts"],"names":[],"mappings":""}

package/dist/esm/identity/index.js

@@ -0,0 +1,19 @@
+// Identity Layer — Barrel exports
+//
+// This module ships two layers:
+//   - Off-chain TypeScript primitives (AgentIdentity, DIDResolver, ...) for
+//     building agent cards, resolving DIDs, scoring reputation, etc.
+//   - On-chain helpers under `./erc8004/` for the canonical Celo ERC-8004
+//     Identity + Reputation registries (re-exported as `erc8004` below).
+export { AgentIdentity } from './agent-identity.js';
+export { DIDResolver } from './did-resolver.js';
+export { AgentCard } from './agent-card.js';
+export { Reputation } from './reputation.js';
+export { OwnerRegistry } from './owner-registry.js';
+// Canonical Celo ERC-8004 helpers — Identity + Reputation registries.
+export * as erc8004 from './erc8004/index.js';
+// Direct re-export of the AgentWalletSet EIP-712 builder. Consumers that vendor a
+// client-safe copy (e.g. the envoy-app web client, which can't bundle the native
+// OWS dep) pin their copy against this to guarantee on-chain signatures match.
+export { agentWalletRotationTypedData } from './erc8004/identity.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/identity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/identity/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,EAAE;AACF,gCAAgC;AAChC,4EAA4E;AAC5E,qEAAqE;AACrE,0EAA0E;AAC1E,yEAAyE;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAkBjD,sEAAsE;AACtE,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAGrC,kFAAkF;AAClF,iFAAiF;AACjF,+EAA+E;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC"}