envoy-pay 0.1.0

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

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERC8004_REPUTATION_ABI = exports.ERC8004_IDENTITY_ABI = void 0;
+exports.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 },
+        ],
+    },
+];
+exports.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/cjs/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/cjs/identity/erc8004/identity.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * 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`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexToBytes = exports.encodePacked = exports.encodeBytesMetadata = exports.encodeStringMetadata = void 0;
+exports.registerAgent = registerAgent;
+exports.setAgentWallet = setAgentWallet;
+exports.unsetAgentWallet = unsetAgentWallet;
+exports.setAgentURI = setAgentURI;
+exports.setMetadata = setMetadata;
+exports.getAgentWallet = getAgentWallet;
+exports.getAgentOwner = getAgentOwner;
+exports.getAgentURI = getAgentURI;
+exports.getMetadata = getMetadata;
+exports.isAuthorizedOrOwner = isAuthorizedOrOwner;
+exports.getAgent = getAgent;
+exports.agentWalletRotationTypedData = agentWalletRotationTypedData;
+exports.contentHash = contentHash;
+const viem_1 = require("viem");
+Object.defineProperty(exports, "encodePacked", { enumerable: true, get: function () { return viem_1.encodePacked; } });
+Object.defineProperty(exports, "hexToBytes", { enumerable: true, get: function () { return viem_1.hexToBytes; } });
+const abis_1 = require("./abis");
+/**
+ * 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).
+ */
+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: abis_1.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: abis_1.ERC8004_IDENTITY_ABI,
+            functionName: 'register',
+            args: [args.agentURI],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    else {
+        txHash = await walletClient.writeContract({
+            address: registryAddress,
+            abi: abis_1.ERC8004_IDENTITY_ABI,
+            functionName: 'register',
+            args: [],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    for (const log of receipt.logs) {
+        if ((0, viem_1.getAddress)(log.address) !== (0, viem_1.getAddress)(registryAddress))
+            continue;
+        try {
+            const decoded = (0, viem_1.decodeEventLog)({
+                abi: abis_1.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.
+ */
+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: abis_1.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. */
+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: abis_1.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). */
+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: abis_1.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. */
+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: abis_1.ERC8004_IDENTITY_ABI,
+        functionName: 'setMetadata',
+        args: [agentId, key, value],
+        account,
+        chain: walletClient.chain,
+    });
+}
+// ---------------------------------------------------------------------------
+// Reads
+// ---------------------------------------------------------------------------
+async function getAgentWallet(publicClient, registryAddress, agentId) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: abis_1.ERC8004_IDENTITY_ABI,
+        functionName: 'getAgentWallet',
+        args: [agentId],
+    });
+}
+async function getAgentOwner(publicClient, registryAddress, agentId) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: abis_1.ERC8004_IDENTITY_ABI,
+        functionName: 'ownerOf',
+        args: [agentId],
+    });
+}
+async function getAgentURI(publicClient, registryAddress, agentId) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: abis_1.ERC8004_IDENTITY_ABI,
+        functionName: 'tokenURI',
+        args: [agentId],
+    });
+}
+async function getMetadata(publicClient, registryAddress, agentId, key) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: abis_1.ERC8004_IDENTITY_ABI,
+        functionName: 'getMetadata',
+        args: [agentId, key],
+    });
+}
+async function isAuthorizedOrOwner(publicClient, registryAddress, spender, agentId) {
+    return publicClient.readContract({
+        address: registryAddress,
+        abi: abis_1.ERC8004_IDENTITY_ABI,
+        functionName: 'isAuthorizedOrOwner',
+        args: [spender, agentId],
+    });
+}
+/** Aggregate read — one round-trip per field. Convenience wrapper. */
+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`.
+ */
+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(...)`. */
+const encodeStringMetadata = (s) => (0, viem_1.stringToHex)(s);
+exports.encodeStringMetadata = encodeStringMetadata;
+/** Encode raw bytes as a metadata value. */
+const encodeBytesMetadata = (b) => (0, viem_1.toHex)(b);
+exports.encodeBytesMetadata = encodeBytesMetadata;
+/** Compute the keccak256 hash an agent card URI's contents would have. Useful for `feedbackHash` etc. */
+function contentHash(bytes) {
+    return (0, viem_1.keccak256)(bytes);
+}
+//# sourceMappingURL=identity.js.map

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

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

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

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * 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)`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERC8004_REPUTATION_ABI = exports.ERC8004_IDENTITY_ABI = exports.makeScoreFeedback = exports.revokeFeedback = exports.giveFeedback = exports.contentHash = exports.encodeBytesMetadata = exports.encodeStringMetadata = exports.agentWalletRotationTypedData = exports.getAgent = exports.isAuthorizedOrOwner = exports.getMetadata = exports.getAgentURI = exports.getAgentOwner = exports.getAgentWallet = exports.setMetadata = exports.setAgentURI = exports.unsetAgentWallet = exports.setAgentWallet = exports.registerAgent = void 0;
+var identity_1 = require("./identity");
+Object.defineProperty(exports, "registerAgent", { enumerable: true, get: function () { return identity_1.registerAgent; } });
+Object.defineProperty(exports, "setAgentWallet", { enumerable: true, get: function () { return identity_1.setAgentWallet; } });
+Object.defineProperty(exports, "unsetAgentWallet", { enumerable: true, get: function () { return identity_1.unsetAgentWallet; } });
+Object.defineProperty(exports, "setAgentURI", { enumerable: true, get: function () { return identity_1.setAgentURI; } });
+Object.defineProperty(exports, "setMetadata", { enumerable: true, get: function () { return identity_1.setMetadata; } });
+Object.defineProperty(exports, "getAgentWallet", { enumerable: true, get: function () { return identity_1.getAgentWallet; } });
+Object.defineProperty(exports, "getAgentOwner", { enumerable: true, get: function () { return identity_1.getAgentOwner; } });
+Object.defineProperty(exports, "getAgentURI", { enumerable: true, get: function () { return identity_1.getAgentURI; } });
+Object.defineProperty(exports, "getMetadata", { enumerable: true, get: function () { return identity_1.getMetadata; } });
+Object.defineProperty(exports, "isAuthorizedOrOwner", { enumerable: true, get: function () { return identity_1.isAuthorizedOrOwner; } });
+Object.defineProperty(exports, "getAgent", { enumerable: true, get: function () { return identity_1.getAgent; } });
+Object.defineProperty(exports, "agentWalletRotationTypedData", { enumerable: true, get: function () { return identity_1.agentWalletRotationTypedData; } });
+Object.defineProperty(exports, "encodeStringMetadata", { enumerable: true, get: function () { return identity_1.encodeStringMetadata; } });
+Object.defineProperty(exports, "encodeBytesMetadata", { enumerable: true, get: function () { return identity_1.encodeBytesMetadata; } });
+Object.defineProperty(exports, "contentHash", { enumerable: true, get: function () { return identity_1.contentHash; } });
+var reputation_1 = require("./reputation");
+Object.defineProperty(exports, "giveFeedback", { enumerable: true, get: function () { return reputation_1.giveFeedback; } });
+Object.defineProperty(exports, "revokeFeedback", { enumerable: true, get: function () { return reputation_1.revokeFeedback; } });
+Object.defineProperty(exports, "makeScoreFeedback", { enumerable: true, get: function () { return reputation_1.makeScoreFeedback; } });
+var abis_1 = require("./abis");
+Object.defineProperty(exports, "ERC8004_IDENTITY_ABI", { enumerable: true, get: function () { return abis_1.ERC8004_IDENTITY_ABI; } });
+Object.defineProperty(exports, "ERC8004_REPUTATION_ABI", { enumerable: true, get: function () { return abis_1.ERC8004_REPUTATION_ABI; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,uCAgBoB;AAflB,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,4GAAA,gBAAgB,OAAA;AAChB,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,+GAAA,mBAAmB,OAAA;AACnB,oGAAA,QAAQ,OAAA;AACR,wHAAA,4BAA4B,OAAA;AAC5B,gHAAA,oBAAoB,OAAA;AACpB,+GAAA,mBAAmB,OAAA;AACnB,uGAAA,WAAW,OAAA;AAIb,2CAA+E;AAAtE,0GAAA,YAAY,OAAA;AAAE,4GAAA,cAAc,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAExD,+BAAsE;AAA7D,4GAAA,oBAAoB,OAAA;AAAE,8GAAA,sBAAsB,OAAA"}

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

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.giveFeedback = giveFeedback;
+exports.revokeFeedback = revokeFeedback;
+exports.makeScoreFeedback = makeScoreFeedback;
+const viem_1 = require("viem");
+const abis_1 = require("./abis");
+/**
+ * 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.
+ */
+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: abis_1.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 ((0, viem_1.getAddress)(log.address) !== (0, viem_1.getAddress)(registryAddress))
+            continue;
+        try {
+            const decoded = (0, viem_1.decodeEventLog)({
+                abi: abis_1.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.
+ */
+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: abis_1.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".
+ */
+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/cjs/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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"}