@antseed/node 0.2.116 → 0.2.118

package/dist/payments/evm/seller-pools-rewards-client.js

@@ -0,0 +1,126 @@
+import { Contract, ZeroAddress } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+import { previewPositionReward, REWARD_INDEX_SCALE } from '../reward-preview.js';
+const ABI = [
+    'function sellerPools() view returns (address)',
+    'function usageAccounting() view returns (address)',
+    'function positionClaimCursor(uint256 positionId) view returns (uint256)',
+    'function poolRewardIndexNextEpoch(uint256 agentId) view returns (uint256)',
+    'function initialIndexEpoch() view returns (uint256)',
+    'function poolCumulativeRewardPerWeightAt(uint256 agentId, uint256 epoch) view returns (uint256)',
+    'function poolCumulativeEpochRewardPerWeightAt(uint256 agentId, uint256 epoch) view returns (uint256)',
+    'function poolEpochEmissions(uint256 epoch, uint256 agentId) view returns (bool, uint256)',
+    'function stakerEpochBudget(uint256 epoch) view returns (uint256)',
+    'function indexPoolRewards(uint256 agentId, uint256 maxEpochs) returns (uint256)',
+    'function pendingIndexedStakerReward(uint256 positionId) external view returns (uint256)',
+    'function claimStakerRewards(uint256 positionId, address recipient) external',
+    'function claimStakerRewardsBatch(uint256[] positionIds, address recipient) external',
+    'function restakeStakerRewards(uint256 positionId, uint256 stakeEpochs) external returns (uint256 newPositionId)',
+    'function restakeStakerRewardsBatch(uint256[] positionIds, uint256 stakeEpochs) external returns (uint256[] newPositionIds)',
+    'function dynamicStakerConfigAt(uint256 epoch) view returns (tuple(uint32 minShareBps, uint32 maxShareBps, uint256 stakeShareTarget))',
+    'function paused() view returns (bool)',
+];
+const POOLS_ABI = [
+    'function positionPowerSegmentAt(uint256 positionId, uint256 epoch) view returns (uint256, uint256, uint256)',
+    'function poolWeightAtEpoch(uint256 agentId, uint256 epoch) view returns (uint256)',
+    'function currentEpoch() view returns (uint256)',
+    'function positions(uint256 positionId) view returns (address, uint256, uint256, uint256, uint64, uint64, uint64, bool)',
+];
+const ACCOUNTING_ABI = [
+    'function weightedPoolPointsByEpoch(uint256 epoch, uint256 agentId) view returns (uint256)',
+    'function totalWeightedPoolPointsByEpoch(uint256 epoch) view returns (uint256)',
+];
+export class SellerPoolsRewardsClient extends BaseEvmClient {
+    constructor(config) { super(config.rpcUrl, config.contractAddress, config.fallbackRpcUrls, config.evmChainId); }
+    pendingIndexedStakerReward(positionId) { return new Contract(this._contractAddress, ABI, this._provider).getFunction('pendingIndexedStakerReward')(positionId); }
+    claimStakerRewards(signer, positionId, recipient) { return this._execWrite(signer, ABI, 'claimStakerRewards', positionId, recipient); }
+    claimStakerRewardsBatch(signer, positionIds, recipient) { return this._execWrite(signer, ABI, 'claimStakerRewardsBatch', positionIds, recipient); }
+    /** Compound indexed staker rewards into a fresh locked position (earns the restake weight bonus). */
+    restakeStakerRewards(signer, positionId, stakeEpochs) { return this._execWrite(signer, ABI, 'restakeStakerRewards', positionId, stakeEpochs); }
+    restakeStakerRewardsBatch(signer, positionIds, stakeEpochs) { return this._execWrite(signer, ABI, 'restakeStakerRewardsBatch', positionIds, stakeEpochs); }
+    stakerEpochBudget(epoch) { return new Contract(this._contractAddress, ABI, this._provider).getFunction('stakerEpochBudget')(epoch); }
+    async poolEpochEmissions(epoch, agentId) {
+        const [settled, amount] = await new Contract(this._contractAddress, ABI, this._provider).getFunction('poolEpochEmissions')(epoch, agentId);
+        return { settled, amount };
+    }
+    async dynamicStakerConfigAt(epoch) {
+        const result = await new Contract(this._contractAddress, ABI, this._provider).getFunction('dynamicStakerConfigAt')(epoch);
+        return { minShareBps: Number(result[0]), maxShareBps: Number(result[1]), stakeShareTarget: result[2] };
+    }
+    paused() { return new Contract(this._contractAddress, ABI, this._provider).getFunction('paused')(); }
+    async positionClaimCursor(positionId) { return Number(await new Contract(this._contractAddress, ABI, this._provider).getFunction('positionClaimCursor')(positionId)); }
+    async previewStakerReward(positionId) {
+        return (await this.previewStakerRewards([positionId]))[0];
+    }
+    async previewStakerRewards(positionIds) {
+        if (positionIds.length === 0)
+            return [];
+        const blockTag = await this.provider.getBlockNumber();
+        const reads = new Map();
+        const read = (contract, method, ...args) => {
+            const key = `${contract.target}:${method}:${args.join(',')}`;
+            let result = reads.get(key);
+            if (!result) {
+                result = contract.getFunction(method)(...args, { blockTag });
+                reads.set(key, result);
+            }
+            return result;
+        };
+        const rewards = new Contract(this.contractAddress, ABI, this.provider);
+        const poolAddress = await read(rewards, 'sellerPools');
+        const pools = new Contract(poolAddress, POOLS_ABI, this.provider);
+        const accounting = new Contract(await read(rewards, 'usageAccounting'), ACCOUNTING_ABI, this.provider);
+        const previewPosition = async (positionId) => {
+            const position = await read(pools, 'positions', positionId);
+            if (position[0] === ZeroAddress)
+                throw new Error(`Unknown position ${positionId}`);
+            return previewPositionReward({
+                id: positionId, owner: position[0], agentId: Number(position[1]), amount: position[2], weightAmount: position[3],
+                stakeStartEpoch: Number(position[4]), stakeEndEpoch: Number(position[5]), closedAtEpoch: Number(position[6]), withdrawn: position[7],
+            }, {
+                currentEpoch: async () => Number(await read(pools, 'currentEpoch')),
+                claimCursor: async (id) => Number(await read(rewards, 'positionClaimCursor', id)),
+                indexCursor: async (agentId) => Number(await read(rewards, 'poolRewardIndexNextEpoch', agentId) || await read(rewards, 'initialIndexEpoch')),
+                segment: async (id, epoch) => {
+                    const [normalEnd, maxLockPower, nextChange] = await read(pools, 'positionPowerSegmentAt', id, epoch);
+                    return { normalEnd, maxLockPower, nextChange };
+                },
+                cumulative: async (agentId, epoch) => ({
+                    reward: await read(rewards, 'poolCumulativeRewardPerWeightAt', agentId, epoch),
+                    epochReward: await read(rewards, 'poolCumulativeEpochRewardPerWeightAt', agentId, epoch),
+                }),
+                rewardPerWeight: async (agentId, epoch) => {
+                    const weight = await read(pools, 'poolWeightAtEpoch', agentId, epoch);
+                    if (weight === 0n)
+                        return 0n;
+                    const [settled, amount] = await read(rewards, 'poolEpochEmissions', epoch, agentId);
+                    if (settled)
+                        return amount * REWARD_INDEX_SCALE / weight;
+                    const [points, total] = await Promise.all([
+                        read(accounting, 'weightedPoolPointsByEpoch', epoch, agentId),
+                        read(accounting, 'totalWeightedPoolPointsByEpoch', epoch),
+                    ]);
+                    if (points === 0n || total === 0n)
+                        return 0n;
+                    const budget = await read(rewards, 'stakerEpochBudget', epoch);
+                    return (budget * points / total) * REWARD_INDEX_SCALE / weight;
+                },
+            });
+        };
+        const amounts = [];
+        for (let offset = 0; offset < positionIds.length; offset += 16) {
+            amounts.push(...await Promise.all(positionIds.slice(offset, offset + 16).map(previewPosition)));
+        }
+        return amounts;
+    }
+    async poolRewardIndexNextEpoch(agentId) {
+        return Number(await new Contract(this.contractAddress, ABI, this.provider).getFunction('poolRewardIndexNextEpoch')(agentId));
+    }
+    async initialIndexEpoch() {
+        return Number(await new Contract(this.contractAddress, ABI, this.provider).getFunction('initialIndexEpoch')());
+    }
+    indexPoolRewards(signer, agentId, maxEpochs) {
+        return this._execWrite(signer, ABI, 'indexPoolRewards', agentId, maxEpochs);
+    }
+}
+//# sourceMappingURL=seller-pools-rewards-client.js.map

package/dist/payments/evm/seller-pools-rewards-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-pools-rewards-client.js","sourceRoot":"","sources":["../../../src/payments/evm/seller-pools-rewards-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAuB,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGjF,MAAM,GAAG,GAAG;IACV,+CAA+C;IAC/C,mDAAmD;IACnD,yEAAyE;IACzE,2EAA2E;IAC3E,qDAAqD;IACrD,iGAAiG;IACjG,sGAAsG;IACtG,0FAA0F;IAC1F,kEAAkE;IAClE,iFAAiF;IACjF,yFAAyF;IACzF,6EAA6E;IAC7E,qFAAqF;IACrF,iHAAiH;IACjH,4HAA4H;IAC5H,sIAAsI;IACtI,uCAAuC;CAC/B,CAAC;AACX,MAAM,SAAS,GAAG;IAChB,6GAA6G;IAC7G,mFAAmF;IACnF,gDAAgD;IAChD,wHAAwH;CACzH,CAAC;AACF,MAAM,cAAc,GAAG;IACrB,2FAA2F;IAC3F,+EAA+E;CAChF,CAAC;AAIF,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,MAAsC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChJ,0BAA0B,CAAC,UAAkB,IAAqB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1L,kBAAkB,CAAC,MAAsB,EAAE,UAAkB,EAAE,SAAiB,IAAqB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,oBAAoB,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACxL,uBAAuB,CAAC,MAAsB,EAAE,WAAqB,EAAE,SAAiB,IAAqB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,yBAAyB,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtM,qGAAqG;IACrG,oBAAoB,CAAC,MAAsB,EAAE,UAAkB,EAAE,WAAmB,IAAqB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,sBAAsB,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChM,yBAAyB,CAAC,MAAsB,EAAE,WAAqB,EAAE,WAAmB,IAAqB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,2BAA2B,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9M,iBAAiB,CAAC,KAAa,IAAqB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9J,KAAK,CAAC,kBAAkB,CAAC,KAAa,EAAE,OAAe;QACrD,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,OAAO,CAAsB,CAAC;QAChK,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IACD,KAAK,CAAC,qBAAqB,CAAC,KAAa;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1H,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACzG,CAAC;IACD,MAAM,KAAuB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACvH,KAAK,CAAC,mBAAmB,CAAC,UAAkB,IAAqB,OAAO,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAChM,KAAK,CAAC,mBAAmB,CAAC,UAAkB;QAC1C,OAAO,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,WAAqB;QAC9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;QAClD,MAAM,IAAI,GAAG,CAAQ,QAAkB,EAAE,MAAc,EAAE,GAAG,IAAyB,EAAkB,EAAE;YACvG,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,MAAM,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7D,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC7D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAO,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO,MAAwB,CAAC;QAClC,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAS,OAAO,EAAE,aAAa,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAS,OAAO,EAAE,iBAAiB,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/G,MAAM,eAAe,GAAG,KAAK,EAAE,UAAkB,EAAmB,EAAE;YACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAoE,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YAC/H,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;YACnF,OAAO,qBAAqB,CAAC;gBAC3B,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAChH,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;aACrI,EAAE;gBACD,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,CAAS,KAAK,EAAE,cAAc,CAAC,CAAC;gBAC3E,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,CAAS,OAAO,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;gBACzF,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,CAAS,OAAO,EAAE,0BAA0B,EAAE,OAAO,CAAC,IAAI,MAAM,IAAI,CAAS,OAAO,EAAE,mBAAmB,CAAC,CAAC;gBAC5J,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE;oBAC3B,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,GAAG,MAAM,IAAI,CAA2B,KAAK,EAAE,wBAAwB,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;oBAC/H,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;gBACjD,CAAC;gBACD,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;oBACrC,MAAM,EAAE,MAAM,IAAI,CAAS,OAAO,EAAE,iCAAiC,EAAE,OAAO,EAAE,KAAK,CAAC;oBACtF,WAAW,EAAE,MAAM,IAAI,CAAS,OAAO,EAAE,sCAAsC,EAAE,OAAO,EAAE,KAAK,CAAC;iBACjG,CAAC;gBACF,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;oBACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAS,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;oBAC9E,IAAI,MAAM,KAAK,EAAE;wBAAE,OAAO,EAAE,CAAC;oBAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAAoB,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;oBACvG,IAAI,OAAO;wBAAE,OAAO,MAAM,GAAG,kBAAkB,GAAG,MAAM,CAAC;oBACzD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;wBACxC,IAAI,CAAS,UAAU,EAAE,2BAA2B,EAAE,KAAK,EAAE,OAAO,CAAC;wBACrE,IAAI,CAAS,UAAU,EAAE,gCAAgC,EAAE,KAAK,CAAC;qBAClE,CAAC,CAAC;oBACH,IAAI,MAAM,KAAK,EAAE,IAAI,KAAK,KAAK,EAAE;wBAAE,OAAO,EAAE,CAAC;oBAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAS,OAAO,EAAE,mBAAmB,EAAE,KAAK,CAAC,CAAC;oBACvE,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG,kBAAkB,GAAG,MAAM,CAAC;gBACjE,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QACF,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,wBAAwB,CAAC,OAAe;QAC5C,OAAO,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/H,CAAC;IACD,KAAK,CAAC,iBAAiB;QACrB,OAAO,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,gBAAgB,CAAC,MAAsB,EAAE,OAAe,EAAE,SAAiB;QACzE,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,kBAAkB,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/payments/evm/seller-registry-client.d.ts

@@ -0,0 +1,28 @@
+import { type AbstractSigner } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+export interface SellerRegistryClientConfig {
+    rpcUrl: string;
+    fallbackRpcUrls?: string[];
+    contractAddress: string;
+    evmChainId?: number;
+}
+export declare class SellerRegistryClient extends BaseEvmClient {
+    constructor(config: SellerRegistryClientConfig);
+    private contract;
+    registerSeller(signer: AbstractSigner, agentId: number): Promise<string>;
+    getAgentId(seller: string): Promise<number>;
+    getStake(seller: string): Promise<bigint>;
+    isStakedAboveMin(seller: string): Promise<boolean>;
+    minSellerPoolStake(): Promise<bigint>;
+    legacyStakeEligibilityEnabled(): Promise<boolean>;
+    isRegisteredSeller(seller: string, agentId: number): Promise<boolean>;
+    getRegisteredAgentId(seller: string): Promise<number>;
+    registerSellerBinding(signer: AbstractSigner, agentId: number, confirmed?: (hash: string) => void | Promise<void>): Promise<boolean>;
+    agentSeller(agentId: number): Promise<string>;
+    sellerPools(): Promise<string>;
+    legacyStaking(): Promise<string>;
+}
+export declare class SellerRegistrationVerificationError extends Error {
+    constructor();
+}
+//# sourceMappingURL=seller-registry-client.d.ts.map

package/dist/payments/evm/seller-registry-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-registry-client.d.ts","sourceRoot":"","sources":["../../../src/payments/evm/seller-registry-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,0BAA0B;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAAE;AAczI,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,MAAM,EAAE,0BAA0B;IAC9C,OAAO,CAAC,QAAQ;IAChB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAClE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACzC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAClD,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IACrC,6BAA6B,IAAI,OAAO,CAAC,OAAO,CAAC;IAC3C,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrE,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrD,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAapJ,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7C,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAC9B,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CACjC;AAED,qBAAa,mCAAoC,SAAQ,KAAK;;CAK7D"}

package/dist/payments/evm/seller-registry-client.js

@@ -0,0 +1,60 @@
+import { Contract } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+const ABI = [
+    'event SellerRegistered(address indexed seller, uint256 indexed agentId)',
+    'function owner() external view returns (address)',
+    'function sellerPools() external view returns (address)',
+    'function legacyStaking() external view returns (address)',
+    'function agentSeller(uint256 agentId) external view returns (address)',
+    'function registerSeller(uint256 agentId) external',
+    'function getAgentId(address seller) external view returns (uint256)',
+    'function getStake(address seller) external view returns (uint256)',
+    'function isStakedAboveMin(address seller) external view returns (bool)',
+    'function minSellerPoolStake() external view returns (uint256)',
+    'function legacyStakeEligibilityEnabled() external view returns (bool)',
+];
+export class SellerRegistryClient extends BaseEvmClient {
+    constructor(config) { super(config.rpcUrl, config.contractAddress, config.fallbackRpcUrls, config.evmChainId); }
+    contract() { return new Contract(this._contractAddress, ABI, this._provider); }
+    registerSeller(signer, agentId) { return this._execWrite(signer, ABI, 'registerSeller', agentId); }
+    async getAgentId(seller) { return Number(await this.contract().getFunction('getAgentId')(seller)); }
+    getStake(seller) { return this.contract().getFunction('getStake')(seller); }
+    isStakedAboveMin(seller) { return this.contract().getFunction('isStakedAboveMin')(seller); }
+    minSellerPoolStake() { return this.contract().getFunction('minSellerPoolStake')(); }
+    legacyStakeEligibilityEnabled() { return this.contract().getFunction('legacyStakeEligibilityEnabled')(); }
+    async isRegisteredSeller(seller, agentId) {
+        if (!agentId)
+            return false;
+        const registry = this.contract();
+        const [resolvedId, boundSeller] = await Promise.all([this.getAgentId(seller), registry.getFunction('agentSeller')(agentId)]);
+        return resolvedId === agentId && boundSeller.toLowerCase() === seller.toLowerCase();
+    }
+    async getRegisteredAgentId(seller) {
+        const agentId = await this.getAgentId(seller);
+        return await this.isRegisteredSeller(seller, agentId) ? agentId : 0;
+    }
+    async registerSellerBinding(signer, agentId, confirmed = () => { }) {
+        const address = await signer.getAddress();
+        const boundAgentId = await this.getAgentId(address);
+        if (boundAgentId !== 0 && boundAgentId !== agentId) {
+            throw new Error(`Seller is already bound to agent ${boundAgentId}, not ${agentId}.`);
+        }
+        if (await this.isRegisteredSeller(address, agentId))
+            return false;
+        await confirmed(await this.registerSeller(signer, agentId));
+        if (!await this.isRegisteredSeller(address, agentId)) {
+            throw new SellerRegistrationVerificationError();
+        }
+        return true;
+    }
+    agentSeller(agentId) { return this.contract().getFunction('agentSeller')(agentId); }
+    sellerPools() { return this.contract().getFunction('sellerPools')(); }
+    legacyStaking() { return this.contract().getFunction('legacyStaking')(); }
+}
+export class SellerRegistrationVerificationError extends Error {
+    constructor() {
+        super('Registration could not be verified.');
+        this.name = 'SellerRegistrationVerificationError';
+    }
+}
+//# sourceMappingURL=seller-registry-client.js.map

package/dist/payments/evm/seller-registry-client.js.map

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

package/dist/payments/evm/seller-rewards-pool-client.d.ts

@@ -0,0 +1,24 @@
+import { type AbstractSigner } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+export interface SellerRewardsPoolClientConfig {
+    rpcUrl: string;
+    fallbackRpcUrls?: string[];
+    contractAddress: string;
+    evmChainId?: number;
+}
+/** Legacy locked seller rewards pool (`AntseedSellerRewardsPool`). Releases are gated by the M002 claim policy. */
+export declare class SellerRewardsPoolClient extends BaseEvmClient {
+    constructor(config: SellerRewardsPoolClientConfig);
+    private contract;
+    lockedRewards(seller: string): Promise<bigint>;
+    totalLockedRewards(): Promise<bigint>;
+    sellerClaimPolicy(): Promise<string>;
+    /** Amount the configured policy would release now; zero when no policy is installed. */
+    claimable(seller: string): Promise<{
+        locked: bigint;
+        claimable: bigint;
+        policy: string;
+    }>;
+    claim(signer: AbstractSigner, recipient: string): Promise<string>;
+}
+//# sourceMappingURL=seller-rewards-pool-client.d.ts.map

package/dist/payments/evm/seller-rewards-pool-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-rewards-pool-client.d.ts","sourceRoot":"","sources":["../../../src/payments/evm/seller-rewards-pool-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,6BAA6B;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAAE;AAW5I,mHAAmH;AACnH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,MAAM,EAAE,6BAA6B;IACjD,OAAO,CAAC,QAAQ;IAEhB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9C,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IACrC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IACpC,wFAAwF;IAClF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/F,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAClE"}

package/dist/payments/evm/seller-rewards-pool-client.js

@@ -0,0 +1,27 @@
+import { Contract, ZeroAddress } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+const ABI = [
+    'function lockedRewards(address seller) external view returns (uint256)',
+    'function totalLockedRewards() external view returns (uint256)',
+    'function sellerClaimPolicy() external view returns (address)',
+    'function claim(address recipient) external',
+];
+const POLICY_ABI = ['function claimableSellerRewards(address seller, uint256 lockedAmount) external view returns (uint256)'];
+/** Legacy locked seller rewards pool (`AntseedSellerRewardsPool`). Releases are gated by the M002 claim policy. */
+export class SellerRewardsPoolClient extends BaseEvmClient {
+    constructor(config) { super(config.rpcUrl, config.contractAddress, config.fallbackRpcUrls, config.evmChainId); }
+    contract() { return new Contract(this._contractAddress, ABI, this._provider); }
+    lockedRewards(seller) { return this.contract().getFunction('lockedRewards')(seller); }
+    totalLockedRewards() { return this.contract().getFunction('totalLockedRewards')(); }
+    sellerClaimPolicy() { return this.contract().getFunction('sellerClaimPolicy')(); }
+    /** Amount the configured policy would release now; zero when no policy is installed. */
+    async claimable(seller) {
+        const [locked, policy] = await Promise.all([this.lockedRewards(seller), this.sellerClaimPolicy()]);
+        if (policy === ZeroAddress || locked === 0n)
+            return { locked, claimable: 0n, policy };
+        const allowed = await new Contract(policy, POLICY_ABI, this._provider).getFunction('claimableSellerRewards')(seller, locked);
+        return { locked, claimable: allowed > locked ? locked : allowed, policy };
+    }
+    claim(signer, recipient) { return this._execWrite(signer, ABI, 'claim', recipient); }
+}
+//# sourceMappingURL=seller-rewards-pool-client.js.map

package/dist/payments/evm/seller-rewards-pool-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-rewards-pool-client.js","sourceRoot":"","sources":["../../../src/payments/evm/seller-rewards-pool-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAuB,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,MAAM,GAAG,GAAG;IACV,wEAAwE;IACxE,+DAA+D;IAC/D,8DAA8D;IAC9D,4CAA4C;CACpC,CAAC;AAEX,MAAM,UAAU,GAAG,CAAC,uGAAuG,CAAU,CAAC;AAEtI,mHAAmH;AACnH,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IACxD,YAAY,MAAqC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACvI,QAAQ,KAAe,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEjG,aAAa,CAAC,MAAc,IAAqB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/G,kBAAkB,KAAsB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC;IACrG,iBAAiB,KAAsB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC;IACnG,wFAAwF;IACxF,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACnG,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,EAAE;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QACtF,MAAM,OAAO,GAAG,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAW,CAAC;QACvI,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC5E,CAAC;IACD,KAAK,CAAC,MAAsB,EAAE,SAAiB,IAAqB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;CAC/H"}

package/dist/payments/evm/usage-accounting-client.d.ts

@@ -0,0 +1,49 @@
+import { type AbstractSigner } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+export interface UsageAccountingClientConfig {
+    rpcUrl: string;
+    fallbackRpcUrls?: string[];
+    contractAddress: string;
+    evmChainId?: number;
+}
+export interface UsagePoints {
+    points: bigint;
+    weightedPoints: bigint;
+}
+export interface UsageTotals {
+    buyers: UsagePoints;
+    sellers: UsagePoints;
+}
+export declare class UsageAccountingClient extends BaseEvmClient {
+    constructor(config: UsageAccountingClientConfig);
+    private contract;
+    currentEpoch(): Promise<number>;
+    firstRewardedEpoch(): Promise<number>;
+    pendingEmissions(account: string, epochs: number[]): Promise<{
+        seller: bigint;
+        buyer: bigint;
+    }>;
+    claimSellerEmissions(signer: AbstractSigner, epochs: number[]): Promise<string>;
+    sellerPointsByEpoch(epoch: number, seller: string): Promise<bigint>;
+    buyerPointsByEpoch(epoch: number, buyer: string): Promise<bigint>;
+    sellerAgentIdByEpoch(epoch: number, seller: string): Promise<number>;
+    totalUsage(): Promise<UsageTotals>;
+    epochUsage(epoch: number): Promise<UsageTotals>;
+    buyerUsageTotal(buyer: string): Promise<UsagePoints>;
+    buyerEpochUsage(epoch: number, buyer: string): Promise<UsagePoints>;
+    agentEpochUsage(epoch: number, agentId: number): Promise<UsagePoints>;
+    totalBuyerPointsByEpoch(epoch: number): Promise<bigint>;
+    totalSellerPointsByEpoch(epoch: number): Promise<bigint>;
+    totalPoolPointsByEpoch(epoch: number): Promise<bigint>;
+    totalWeightedPoolPointsByEpoch(epoch: number): Promise<bigint>;
+    totalWeightedBuyerPointsByEpoch(epoch: number): Promise<bigint>;
+    agentPoolPointsByEpoch(epoch: number, agentId: number): Promise<bigint>;
+    weightedPoolPointsByEpoch(epoch: number, agentId: number): Promise<bigint>;
+    weightedBuyerPointsByEpoch(epoch: number, buyer: string): Promise<bigint>;
+    pointsPolicy(): Promise<string>;
+    poolWeightPolicy(): Promise<string>;
+    minimumAccountedPoolPower(): Promise<bigint>;
+    sellerPools(): Promise<string>;
+    usageRewards(): Promise<string>;
+}
+//# sourceMappingURL=usage-accounting-client.d.ts.map

package/dist/payments/evm/usage-accounting-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-accounting-client.d.ts","sourceRoot":"","sources":["../../../src/payments/evm/usage-accounting-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;CAAE;AACxE,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;CAAE;AAmC3E,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,MAAM,EAAE,2BAA2B;IAG/C,OAAO,CAAC,QAAQ;IAEV,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAC/B,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IACrC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrG,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAG/E,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGnE,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAG3D,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGpE,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAIlC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/C,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACpD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACnE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAC3E,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvD,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACxD,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACtD,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9D,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/D,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvE,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC1E,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACzE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAC/B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IACnC,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC;IAC5C,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAC9B,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;CAChC"}

package/dist/payments/evm/usage-accounting-client.js

@@ -0,0 +1,82 @@
+import { Contract } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+const USAGE_ACCOUNTING_ABI = [
+    'function currentEpoch() external view returns (uint256)',
+    'function firstRewardedEpoch() external view returns (uint256)',
+    'function pendingEmissions(address account, uint256[] epochs) external view returns (uint256 seller, uint256 buyer)',
+    'function claimSellerEmissions(uint256[] epochs) external',
+    'function sellerPointsByEpoch(uint256 epoch, address seller) external view returns (uint256)',
+    'function buyerPointsByEpoch(uint256 epoch, address buyer) external view returns (uint256)',
+    'function sellerAgentIdByEpoch(uint256 epoch, address seller) external view returns (uint256)',
+    'function totalUsage() external view returns (tuple(tuple(uint256 points, uint256 weightedPoints) buyers, tuple(uint256 points, uint256 weightedPoints) sellers))',
+    'function epochUsage(uint256 epoch) external view returns (tuple(tuple(uint256 points, uint256 weightedPoints) buyers, tuple(uint256 points, uint256 weightedPoints) sellers))',
+    'function buyerUsageTotal(address buyer) external view returns (tuple(uint256 points, uint256 weightedPoints))',
+    'function buyerEpochUsage(uint256 epoch, address buyer) external view returns (tuple(uint256 points, uint256 weightedPoints))',
+    'function agentEpochUsage(uint256 epoch, uint256 agentId) external view returns (tuple(uint256 points, uint256 weightedPoints))',
+    'function totalBuyerPointsByEpoch(uint256 epoch) external view returns (uint256)',
+    'function totalSellerPointsByEpoch(uint256 epoch) external view returns (uint256)',
+    'function totalPoolPointsByEpoch(uint256 epoch) external view returns (uint256)',
+    'function totalWeightedPoolPointsByEpoch(uint256 epoch) external view returns (uint256)',
+    'function totalWeightedBuyerPointsByEpoch(uint256 epoch) external view returns (uint256)',
+    'function agentPoolPointsByEpoch(uint256 epoch, uint256 agentId) external view returns (uint256)',
+    'function weightedPoolPointsByEpoch(uint256 epoch, uint256 agentId) external view returns (uint256)',
+    'function weightedBuyerPointsByEpoch(uint256 epoch, address buyer) external view returns (uint256)',
+    'function pointsPolicy() external view returns (address)',
+    'function poolWeightPolicy() external view returns (address)',
+    'function minimumAccountedPoolPower() external view returns (uint256)',
+    'function sellerPools() external view returns (address)',
+    'function usageRewards() external view returns (address)',
+];
+function toPoints(result) {
+    const tuple = result;
+    return { points: tuple[0], weightedPoints: tuple[1] };
+}
+export class UsageAccountingClient extends BaseEvmClient {
+    constructor(config) {
+        super(config.rpcUrl, config.contractAddress, config.fallbackRpcUrls, config.evmChainId);
+    }
+    contract() { return new Contract(this._contractAddress, USAGE_ACCOUNTING_ABI, this._provider); }
+    async currentEpoch() { return Number(await this.contract().getFunction('currentEpoch')()); }
+    async firstRewardedEpoch() { return Number(await this.contract().getFunction('firstRewardedEpoch')()); }
+    async pendingEmissions(account, epochs) {
+        const [seller, buyer] = await this.contract().getFunction('pendingEmissions')(account, epochs);
+        return { seller, buyer };
+    }
+    claimSellerEmissions(signer, epochs) {
+        return this._execWrite(signer, USAGE_ACCOUNTING_ABI, 'claimSellerEmissions', epochs);
+    }
+    sellerPointsByEpoch(epoch, seller) {
+        return this.contract().getFunction('sellerPointsByEpoch')(epoch, seller);
+    }
+    buyerPointsByEpoch(epoch, buyer) {
+        return this.contract().getFunction('buyerPointsByEpoch')(epoch, buyer);
+    }
+    async sellerAgentIdByEpoch(epoch, seller) {
+        return Number(await this.contract().getFunction('sellerAgentIdByEpoch')(epoch, seller));
+    }
+    async totalUsage() {
+        const result = await this.contract().getFunction('totalUsage')();
+        return { buyers: toPoints(result[0]), sellers: toPoints(result[1]) };
+    }
+    async epochUsage(epoch) {
+        const result = await this.contract().getFunction('epochUsage')(epoch);
+        return { buyers: toPoints(result[0]), sellers: toPoints(result[1]) };
+    }
+    async buyerUsageTotal(buyer) { return toPoints(await this.contract().getFunction('buyerUsageTotal')(buyer)); }
+    async buyerEpochUsage(epoch, buyer) { return toPoints(await this.contract().getFunction('buyerEpochUsage')(epoch, buyer)); }
+    async agentEpochUsage(epoch, agentId) { return toPoints(await this.contract().getFunction('agentEpochUsage')(epoch, agentId)); }
+    totalBuyerPointsByEpoch(epoch) { return this.contract().getFunction('totalBuyerPointsByEpoch')(epoch); }
+    totalSellerPointsByEpoch(epoch) { return this.contract().getFunction('totalSellerPointsByEpoch')(epoch); }
+    totalPoolPointsByEpoch(epoch) { return this.contract().getFunction('totalPoolPointsByEpoch')(epoch); }
+    totalWeightedPoolPointsByEpoch(epoch) { return this.contract().getFunction('totalWeightedPoolPointsByEpoch')(epoch); }
+    totalWeightedBuyerPointsByEpoch(epoch) { return this.contract().getFunction('totalWeightedBuyerPointsByEpoch')(epoch); }
+    agentPoolPointsByEpoch(epoch, agentId) { return this.contract().getFunction('agentPoolPointsByEpoch')(epoch, agentId); }
+    weightedPoolPointsByEpoch(epoch, agentId) { return this.contract().getFunction('weightedPoolPointsByEpoch(uint256,uint256)')(epoch, agentId); }
+    weightedBuyerPointsByEpoch(epoch, buyer) { return this.contract().getFunction('weightedBuyerPointsByEpoch')(epoch, buyer); }
+    pointsPolicy() { return this.contract().getFunction('pointsPolicy')(); }
+    poolWeightPolicy() { return this.contract().getFunction('poolWeightPolicy')(); }
+    minimumAccountedPoolPower() { return this.contract().getFunction('minimumAccountedPoolPower')(); }
+    sellerPools() { return this.contract().getFunction('sellerPools')(); }
+    usageRewards() { return this.contract().getFunction('usageRewards')(); }
+}
+//# sourceMappingURL=usage-accounting-client.js.map

package/dist/payments/evm/usage-accounting-client.js.map

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

package/dist/payments/evm/usage-rewards-client.d.ts

@@ -0,0 +1,43 @@
+import { type AbstractSigner } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+export interface UsageRewardsClientConfig {
+    rpcUrl: string;
+    fallbackRpcUrls?: string[];
+    contractAddress: string;
+    evmChainId?: number;
+}
+export interface DynamicUsageConfig {
+    buyerMinShareBps: number;
+    buyerMaxShareBps: number;
+    sellerMinShareBps: number;
+    sellerMaxShareBps: number;
+    volumeShareTarget: bigint;
+}
+export declare class UsageRewardsClient extends BaseEvmClient {
+    constructor(config: UsageRewardsClientConfig);
+    private contract;
+    pendingAgentReward(agentId: number, epoch: number): Promise<bigint>;
+    pendingBuyerReward(buyer: string, epoch: number): Promise<bigint>;
+    agentEpochClaimed(agentId: number, epoch: number): Promise<boolean>;
+    buyerEpochClaimed(buyer: string, epoch: number): Promise<boolean>;
+    claimAgentReward(signer: AbstractSigner, agentId: number, epoch: number): Promise<string>;
+    claimBuyerReward(signer: AbstractSigner, buyer: string, epoch: number): Promise<string>;
+    /** Claim an agent's usage reward straight into a new locked pool position (agent owner only). */
+    stakeAgentReward(signer: AbstractSigner, agentId: number, epoch: number, stakeEpochs: number): Promise<string>;
+    /** Claim a buyer's usage reward straight into a new locked pool position (deposits operator only). */
+    stakeBuyerReward(signer: AbstractSigner, buyer: string, epoch: number, stakeAgentId: number, stakeEpochs: number): Promise<string>;
+    rewardRecipient(agentId: number): Promise<string>;
+    buyerEpochBudget(epoch: number): Promise<bigint>;
+    sellerEpochBudget(epoch: number): Promise<bigint>;
+    usageEpochBudgets(epoch: number): Promise<{
+        buyer: bigint;
+        seller: bigint;
+    }>;
+    allocatedEpochBudget(epoch: number): Promise<bigint>;
+    dynamicUsageConfigAt(epoch: number): Promise<DynamicUsageConfig>;
+    operatorSource(): Promise<string>;
+    claimForwarder(): Promise<string>;
+    paused(): Promise<boolean>;
+    maxRewardShareBps(): Promise<number>;
+}
+//# sourceMappingURL=usage-rewards-client.d.ts.map

package/dist/payments/evm/usage-rewards-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-rewards-client.d.ts","sourceRoot":"","sources":["../../../src/payments/evm/usage-rewards-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAuBD,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,MAAM,EAAE,wBAAwB;IAG5C,OAAO,CAAC,QAAQ;IAEhB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACnE,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjE,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IACnE,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IACjE,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACzF,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvF,iGAAiG;IACjG,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAG9G,sGAAsG;IACtG,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGlI,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAChD,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3C,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAIlF,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9C,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOtE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IACjC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IACjC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IACpB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAC3C"}

package/dist/payments/evm/usage-rewards-client.js

@@ -0,0 +1,62 @@
+import { Contract } from 'ethers';
+import { BaseEvmClient } from './base-evm-client.js';
+const USAGE_REWARDS_ABI = [
+    'function pendingAgentReward(uint256 agentId, uint256 epoch) external view returns (uint256)',
+    'function pendingBuyerReward(address buyer, uint256 epoch) external view returns (uint256)',
+    'function agentEpochClaimed(uint256 agentId, uint256 epoch) external view returns (bool)',
+    'function buyerEpochClaimed(address buyer, uint256 epoch) external view returns (bool)',
+    'function claimAgentReward(uint256 agentId, uint256 epoch) external',
+    'function claimBuyerReward(address buyer, uint256 epoch) external',
+    'function stakeAgentReward(uint256 agentId, uint256 epoch, uint256 stakeEpochs) external returns (uint256 newPositionId)',
+    'function stakeBuyerReward(address buyer, uint256 epoch, uint256 stakeAgentId, uint256 stakeEpochs) external returns (uint256 newPositionId)',
+    'function rewardRecipient(uint256 agentId) external view returns (address)',
+    'function buyerEpochBudget(uint256 epoch) external view returns (uint256)',
+    'function sellerEpochBudget(uint256 epoch) external view returns (uint256)',
+    'function usageEpochBudgets(uint256 epoch) external view returns (uint256 buyerBudget, uint256 sellerBudget)',
+    'function allocatedEpochBudget(uint256 epoch) external view returns (uint256)',
+    'function dynamicUsageConfigAt(uint256 epoch) external view returns (tuple(uint32 buyerMinShareBps, uint32 buyerMaxShareBps, uint32 sellerMinShareBps, uint32 sellerMaxShareBps, uint256 volumeShareTarget))',
+    'function operatorSource() external view returns (address)',
+    'function claimForwarder() external view returns (address)',
+    'function paused() external view returns (bool)',
+    'function MAX_REWARD_SHARE_BPS() external view returns (uint256)',
+];
+export class UsageRewardsClient extends BaseEvmClient {
+    constructor(config) {
+        super(config.rpcUrl, config.contractAddress, config.fallbackRpcUrls, config.evmChainId);
+    }
+    contract() { return new Contract(this._contractAddress, USAGE_REWARDS_ABI, this._provider); }
+    pendingAgentReward(agentId, epoch) { return this.contract().getFunction('pendingAgentReward')(agentId, epoch); }
+    pendingBuyerReward(buyer, epoch) { return this.contract().getFunction('pendingBuyerReward')(buyer, epoch); }
+    agentEpochClaimed(agentId, epoch) { return this.contract().getFunction('agentEpochClaimed')(agentId, epoch); }
+    buyerEpochClaimed(buyer, epoch) { return this.contract().getFunction('buyerEpochClaimed')(buyer, epoch); }
+    claimAgentReward(signer, agentId, epoch) { return this._execWrite(signer, USAGE_REWARDS_ABI, 'claimAgentReward', agentId, epoch); }
+    claimBuyerReward(signer, buyer, epoch) { return this._execWrite(signer, USAGE_REWARDS_ABI, 'claimBuyerReward', buyer, epoch); }
+    /** Claim an agent's usage reward straight into a new locked pool position (agent owner only). */
+    stakeAgentReward(signer, agentId, epoch, stakeEpochs) {
+        return this._execWrite(signer, USAGE_REWARDS_ABI, 'stakeAgentReward', agentId, epoch, stakeEpochs);
+    }
+    /** Claim a buyer's usage reward straight into a new locked pool position (deposits operator only). */
+    stakeBuyerReward(signer, buyer, epoch, stakeAgentId, stakeEpochs) {
+        return this._execWrite(signer, USAGE_REWARDS_ABI, 'stakeBuyerReward', buyer, epoch, stakeAgentId, stakeEpochs);
+    }
+    rewardRecipient(agentId) { return this.contract().getFunction('rewardRecipient')(agentId); }
+    buyerEpochBudget(epoch) { return this.contract().getFunction('buyerEpochBudget')(epoch); }
+    sellerEpochBudget(epoch) { return this.contract().getFunction('sellerEpochBudget')(epoch); }
+    async usageEpochBudgets(epoch) {
+        const [buyer, seller] = await this.contract().getFunction('usageEpochBudgets')(epoch);
+        return { buyer, seller };
+    }
+    allocatedEpochBudget(epoch) { return this.contract().getFunction('allocatedEpochBudget')(epoch); }
+    async dynamicUsageConfigAt(epoch) {
+        const result = await this.contract().getFunction('dynamicUsageConfigAt')(epoch);
+        return {
+            buyerMinShareBps: Number(result[0]), buyerMaxShareBps: Number(result[1]),
+            sellerMinShareBps: Number(result[2]), sellerMaxShareBps: Number(result[3]), volumeShareTarget: result[4],
+        };
+    }
+    operatorSource() { return this.contract().getFunction('operatorSource')(); }
+    claimForwarder() { return this.contract().getFunction('claimForwarder')(); }
+    paused() { return this.contract().getFunction('paused')(); }
+    async maxRewardShareBps() { return Number(await this.contract().getFunction('MAX_REWARD_SHARE_BPS')()); }
+}
+//# sourceMappingURL=usage-rewards-client.js.map

package/dist/payments/evm/usage-rewards-client.js.map

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