@reppo/cli 0.1.0

package/dist/commands/claim-emissions.js

@@ -0,0 +1,192 @@
+/**
+ * `reppo claim-emissions --pod <id> --epoch <n>` — claim a pod's
+ * emissions for a given epoch.
+ *
+ * Pre-flight (mainnet, full ABI):
+ *   1. INVALID_POD_ID, INVALID_EPOCH (parse)
+ *   2. NOT_POD_OWNER (ownerOf(podId) !== caller)
+ *   3. ALREADY_CLAIMED (hasPodOwnerClaimedEmissions(epoch, podId) === true)
+ *   4. NO_EMISSIONS_DUE (getPodEmissionsOfEpoch(epoch, podId) === 0)
+ *
+ * Pre-flight (testnet, partial ABI):
+ *   1. INVALID_POD_ID, INVALID_EPOCH
+ *   2. NOT_POD_OWNER
+ *   (testnet ABI doesn't include hasPodOwnerClaimedEmissions or
+ *    getPodEmissionsOfEpoch — caller bears the cost of a doomed
+ *    re-claim. Documented in usage.)
+ *
+ * Two-phase write protocol via peekIdempotent.
+ *
+ * Args fingerprint: { podId, epoch } — re-using one --idempotency-key
+ * across different (podId, epoch) is rejected with IDEMPOTENCY_ARGS_MISMATCH.
+ */
+import { Option } from 'clipanion';
+import { formatUnits } from 'viem';
+import { BaseCommand } from './_base.js';
+import { cliError, emit } from '../output/format.js';
+import { createClients, nextNonce } from '../chain/clients.js';
+import { podManager } from '../chain/contracts.js';
+import { decodeRevert } from '../chain/errors.js';
+import { begin, markSubmitted, markConfirmed, markFailed, peekIdempotent } from '../state/idempotency.js';
+const COMMAND = 'claim-emissions';
+export class ClaimEmissionsCommand extends BaseCommand {
+    static paths = [['claim-emissions']];
+    static usage = BaseCommand.Usage({
+        description: 'Claim a pod\'s emissions for a given epoch.',
+        examples: [
+            ['Claim emissions for pod 34, epoch 3940',
+                'reppo claim-emissions --pod 34 --epoch 3940'],
+            ['With idempotency key',
+                'reppo claim-emissions --pod 34 --epoch 3940 --idempotency-key claim-34-3940'],
+            ['Dry-run',
+                'reppo claim-emissions --pod 34 --epoch 3940 --dry-run'],
+        ],
+    });
+    pod = Option.String('--pod', { required: true });
+    epoch = Option.String('--epoch', { required: true });
+    idempotencyKey = Option.String('--idempotency-key');
+    dryRun = Option.Boolean('--dry-run', false);
+    async execute() {
+        try {
+            const cfg = this.loadConfig();
+            const pk = cfg.privateKey;
+            if (!pk) {
+                throw cliError('MISSING_PRIVATE_KEY', 'No signing key available.', 'Set REPPO_PRIVATE_KEY in env.');
+            }
+            let podId;
+            try {
+                podId = BigInt(this.pod);
+            }
+            catch {
+                throw cliError('INVALID_POD_ID', `Pod id must be a non-negative integer; got "${this.pod}".`);
+            }
+            let epoch;
+            try {
+                epoch = BigInt(this.epoch);
+            }
+            catch {
+                throw cliError('INVALID_EPOCH', `Epoch must be a non-negative integer; got "${this.epoch}".`);
+            }
+            const args = { podId: podId.toString(), epoch: epoch.toString() };
+            const decision = await peekIdempotent(this.idempotencyKey, COMMAND, args, this.dryRun);
+            if (decision.kind === 'return-confirmed') {
+                emit({ ...decision.result, idempotent: true, status: 'confirmed' }, [`(cached, confirmed) tx: ${decision.txHash ?? 'n/a'}`]);
+                return 0;
+            }
+            if (decision.kind === 'return-submitted') {
+                emit({ ...decision.result, idempotent: true, status: 'submitted' }, [`(cached, submitted but not confirmed yet) tx: ${decision.txHash ?? 'n/a'}`,
+                    `Re-run after the tx confirms, or check the explorer.`]);
+                return 0;
+            }
+            const clients = createClients({
+                network: cfg.network,
+                privateKey: pk,
+                ...(cfg.rpcUrl ? { rpcUrl: cfg.rpcUrl } : {}),
+            });
+            const pm = podManager(cfg.network);
+            // Pre-flight: ownership (both networks support ownerOf).
+            const owner = await clients.publicClient.readContract({
+                address: pm.address, abi: pm.abi, functionName: 'ownerOf', args: [podId],
+            }).catch(() => {
+                throw cliError('POD_NOT_FOUND', `Pod ${podId} does not exist on ${cfg.network}.`, 'Verify the podId; check `reppo query pod <id>` first.');
+            });
+            if (owner.toLowerCase() !== clients.account.address.toLowerCase()) {
+                throw cliError('NOT_POD_OWNER', `Pod ${podId} is owned by ${owner}, not by the configured signer ${clients.account.address}.`, 'Use the private key of the pod owner.');
+            }
+            // Mainnet-only pre-flight: claim status + amount due.
+            // Testnet's PodManager ABI doesn't expose these views (the testnet fork is leaner).
+            let amountDue = null;
+            if (cfg.network === 'mainnet') {
+                const [alreadyClaimed, due] = await Promise.all([
+                    clients.publicClient.readContract({
+                        address: pm.address, abi: pm.abi, functionName: 'hasPodOwnerClaimedEmissions', args: [epoch, podId],
+                    }),
+                    clients.publicClient.readContract({
+                        address: pm.address, abi: pm.abi, functionName: 'getPodEmissionsOfEpoch', args: [epoch, podId],
+                    }),
+                ]);
+                if (alreadyClaimed) {
+                    throw cliError('ALREADY_CLAIMED', `Pod ${podId} emissions for epoch ${epoch} have already been claimed.`, 'Nothing to do — pick a different epoch.');
+                }
+                if (due === 0n) {
+                    throw cliError('NO_EMISSIONS_DUE', `Pod ${podId} has no emissions due for epoch ${epoch}.`, 'Try a different epoch (e.g. one where the pod received votes).');
+                }
+                amountDue = due;
+            }
+            if (this.dryRun) {
+                const sim = await clients.publicClient.simulateContract({
+                    address: pm.address, abi: pm.abi, functionName: 'claimPodOwnerEmissions',
+                    args: [podId, epoch], account: clients.account,
+                }).catch((e) => {
+                    const decoded = decodeRevert(e);
+                    throw cliError(decoded.code, 'Simulation reverted', decoded.hint);
+                });
+                emit({
+                    simulated: true,
+                    podId: podId.toString(),
+                    epoch: epoch.toString(),
+                    owner,
+                    ...(amountDue !== null
+                        ? { amountDue: { raw: amountDue.toString(), formatted: formatUnits(amountDue, 18) } }
+                        : { amountDue: { unavailable: 'testnet ABI does not expose getPodEmissionsOfEpoch' } }),
+                    gas: sim.request.gas?.toString() ?? null,
+                });
+                return 0;
+            }
+            if (this.idempotencyKey)
+                await begin(this.idempotencyKey, COMMAND, args);
+            let tx;
+            try {
+                const nonce = await nextNonce(clients.publicClient, clients.account.address);
+                tx = await clients.walletClient.writeContract({
+                    address: pm.address, abi: pm.abi, functionName: 'claimPodOwnerEmissions',
+                    args: [podId, epoch],
+                    chain: clients.walletClient.chain, account: clients.account, nonce,
+                });
+            }
+            catch (e) {
+                const decoded = decodeRevert(e);
+                if (this.idempotencyKey)
+                    await markFailed(this.idempotencyKey, COMMAND, args, decoded.code);
+                throw cliError(decoded.code, 'claim-emissions tx failed to submit', decoded.hint);
+            }
+            // markSubmitted BEFORE waitForReceipt — closes the retry-resend window.
+            if (this.idempotencyKey)
+                await markSubmitted(this.idempotencyKey, COMMAND, args, tx);
+            const receipt = await clients.publicClient.waitForTransactionReceipt({ hash: tx, timeout: 120_000 });
+            if (receipt.status === 'reverted') {
+                if (this.idempotencyKey)
+                    await markFailed(this.idempotencyKey, COMMAND, args, 'TX_REVERTED', tx);
+                throw cliError('TX_REVERTED', `claim-emissions tx reverted: ${tx}`);
+            }
+            const result = {
+                txHash: tx,
+                podId: podId.toString(),
+                epoch: epoch.toString(),
+                ...(amountDue !== null
+                    ? { amountClaimed: { raw: amountDue.toString(), formatted: formatUnits(amountDue, 18) } }
+                    : { amountClaimed: { unavailable: 'testnet ABI does not expose getPodEmissionsOfEpoch' } }),
+                block: receipt.blockNumber.toString(),
+                basescanUrl: cfg.network === 'mainnet'
+                    ? `https://basescan.org/tx/${tx}`
+                    : `https://sepolia.basescan.org/tx/${tx}`,
+            };
+            if (this.idempotencyKey)
+                await markConfirmed(this.idempotencyKey, COMMAND, args, result, tx);
+            const amountStr = amountDue !== null
+                ? `${formatUnits(amountDue, 18)} REPPO`
+                : '(amount unknown — testnet)';
+            emit(result, [
+                `✓ Claimed pod ${podId} emissions for epoch ${epoch}`,
+                `  amount: ${amountStr}`,
+                `  tx: ${result.basescanUrl}`,
+                `  block: ${receipt.blockNumber}`,
+            ]);
+            return 0;
+        }
+        catch (err) {
+            this.handleError(err);
+        }
+    }
+}
+//# sourceMappingURL=claim-emissions.js.map

package/dist/commands/claim-emissions.js.map

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

package/dist/commands/extend-lock.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from './_base.js';
+export declare class ExtendLockCommand extends BaseCommand {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    lockupId: string;
+    duration: string;
+    idempotencyKey: string | undefined;
+    dryRun: boolean;
+    execute(): Promise<number>;
+}
+//# sourceMappingURL=extend-lock.d.ts.map

package/dist/commands/extend-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-lock.d.ts","sourceRoot":"","sources":["../../src/commands/extend-lock.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASzC,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAgB,KAAK,aAAqB;IAE1C,OAAgB,KAAK,4BAUlB;IAEH,QAAQ,SAAqC;IAC7C,QAAQ,SAAgG;IACxG,cAAc,qBAAsC;IACpD,MAAM,UAAsC;IAEtC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAoLjC"}

package/dist/commands/extend-lock.js

@@ -0,0 +1,196 @@
+/**
+ * `reppo extend-lock <lockupId> --duration <seconds>` — extend an
+ * existing veREPPO lockup's expiry by `duration` more seconds.
+ *
+ * Pre-flight checks (read-only) before sending:
+ *   1. Caller owns the lockup (ownerOf(lockupId) === caller address)
+ *   2. Duration is within [minStakeDuration, maxStakeDuration]
+ *   3. Capture lockupData(lockupId) for before/after state in the result
+ *
+ * Idempotency two-phase write protocol:
+ *   begin → submit tx → markSubmitted → wait receipt → markConfirmed
+ *
+ * Args fingerprint: { lockupId, duration } — re-using one --idempotency-key
+ * with a different lockupId or duration is rejected with
+ * IDEMPOTENCY_ARGS_MISMATCH.
+ */
+import { Option } from 'clipanion';
+import { BaseCommand } from './_base.js';
+import { cliError, emit } from '../output/format.js';
+import { createClients, nextNonce } from '../chain/clients.js';
+import { veReppo } from '../chain/contracts.js';
+import { decodeRevert } from '../chain/errors.js';
+import { begin, markSubmitted, markConfirmed, markFailed, peekIdempotent } from '../state/idempotency.js';
+const COMMAND = 'extend-lock';
+export class ExtendLockCommand extends BaseCommand {
+    static paths = [['extend-lock']];
+    static usage = BaseCommand.Usage({
+        description: 'Extend an existing veREPPO lockup by `duration` more seconds.',
+        examples: [
+            ['Extend lockup 7 by 1 day',
+                'reppo extend-lock 7 --duration 86400'],
+            ['With idempotency key',
+                'reppo extend-lock 7 --duration 86400 --idempotency-key extend-7-1d'],
+            ['Dry-run (simulate only)',
+                'reppo extend-lock 7 --duration 86400 --dry-run'],
+        ],
+    });
+    lockupId = Option.String({ required: true });
+    duration = Option.String('--duration', { required: true, description: 'Seconds to add to the lockup' });
+    idempotencyKey = Option.String('--idempotency-key');
+    dryRun = Option.Boolean('--dry-run', false);
+    async execute() {
+        try {
+            const cfg = this.loadConfig();
+            const pk = cfg.privateKey;
+            if (!pk) {
+                throw cliError('MISSING_PRIVATE_KEY', 'No signing key available.', 'Set REPPO_PRIVATE_KEY in env.');
+            }
+            let lockupId;
+            try {
+                lockupId = BigInt(this.lockupId);
+            }
+            catch {
+                throw cliError('INVALID_LOCKUP_ID', `Lockup id must be a non-negative integer; got "${this.lockupId}".`);
+            }
+            let duration;
+            try {
+                duration = BigInt(this.duration);
+            }
+            catch {
+                throw cliError('INVALID_DURATION', `Duration must be a non-negative integer (seconds); got "${this.duration}".`);
+            }
+            if (duration <= 0n) {
+                throw cliError('INVALID_DURATION', 'Duration must be greater than 0 seconds.');
+            }
+            const args = { lockupId: lockupId.toString(), duration: duration.toString() };
+            const decision = await peekIdempotent(this.idempotencyKey, COMMAND, args, this.dryRun);
+            if (decision.kind === 'return-confirmed') {
+                emit({ ...decision.result, idempotent: true, status: 'confirmed' }, [`(cached, confirmed) tx: ${decision.txHash ?? 'n/a'}`]);
+                return 0;
+            }
+            if (decision.kind === 'return-submitted') {
+                emit({ ...decision.result, idempotent: true, status: 'submitted' }, [`(cached, submitted but not confirmed yet) tx: ${decision.txHash ?? 'n/a'}`,
+                    `Re-run after the tx confirms, or check the explorer.`]);
+                return 0;
+            }
+            const clients = createClients({
+                network: cfg.network,
+                privateKey: pk,
+                ...(cfg.rpcUrl ? { rpcUrl: cfg.rpcUrl } : {}),
+            });
+            const vr = veReppo(cfg.network); // throws ADDRESS_NOT_CONFIGURED on TBD networks
+            // Pre-flight: ownership
+            const owner = await clients.publicClient.readContract({
+                address: vr.address, abi: vr.abi, functionName: 'ownerOf', args: [lockupId],
+            }).catch(() => {
+                // Lockup doesn't exist (ownerOf reverts per ERC-721).
+                throw cliError('LOCKUP_NOT_FOUND', `Lockup ${lockupId} does not exist on ${cfg.network}.`, 'Verify the lockupId; check `reppo query voting-power` to find your active lockups.');
+            });
+            if (owner.toLowerCase() !== clients.account.address.toLowerCase()) {
+                throw cliError('NOT_LOCKUP_OWNER', `Lockup ${lockupId} is owned by ${owner}, not by the configured signer ${clients.account.address}.`, 'Use the private key of the lockup owner, or pass an idempotency key derived from a different intent.');
+            }
+            // Pre-flight: duration bounds
+            const [minDur, maxDur] = await Promise.all([
+                clients.publicClient.readContract({
+                    address: vr.address, abi: vr.abi, functionName: 'minStakeDuration', args: [],
+                }),
+                clients.publicClient.readContract({
+                    address: vr.address, abi: vr.abi, functionName: 'maxStakeDuration', args: [],
+                }),
+            ]);
+            if (duration < minDur || duration > maxDur) {
+                throw cliError('DURATION_OUT_OF_BOUNDS', `Duration ${duration}s is outside the allowed range [${minDur}, ${maxDur}].`, `Pass --duration with a value in seconds between ${minDur} and ${maxDur}.`);
+            }
+            // Capture before-state for the result payload (also surfaces in dry-run).
+            const lockupBefore = await clients.publicClient.readContract({
+                address: vr.address, abi: vr.abi, functionName: 'lockupData', args: [lockupId],
+            });
+            if (this.dryRun) {
+                const sim = await clients.publicClient.simulateContract({
+                    address: vr.address, abi: vr.abi, functionName: 'extendLock',
+                    args: [lockupId, duration], account: clients.account,
+                }).catch((e) => {
+                    const decoded = decodeRevert(e);
+                    throw cliError(decoded.code, 'Simulation reverted', decoded.hint);
+                });
+                emit({
+                    simulated: true,
+                    lockupId: lockupId.toString(),
+                    durationAdded: duration.toString(),
+                    owner,
+                    lockupBefore: {
+                        amount: lockupBefore[0].toString(),
+                        expiresAt: lockupBefore[1].toString(),
+                        votingPower: lockupBefore[3].toString(),
+                    },
+                    gas: sim.request.gas?.toString() ?? null,
+                });
+                return 0;
+            }
+            if (this.idempotencyKey)
+                await begin(this.idempotencyKey, COMMAND, args);
+            let tx;
+            try {
+                const nonce = await nextNonce(clients.publicClient, clients.account.address);
+                tx = await clients.walletClient.writeContract({
+                    address: vr.address, abi: vr.abi, functionName: 'extendLock',
+                    args: [lockupId, duration],
+                    chain: clients.walletClient.chain, account: clients.account, nonce,
+                });
+            }
+            catch (e) {
+                const decoded = decodeRevert(e);
+                if (this.idempotencyKey)
+                    await markFailed(this.idempotencyKey, COMMAND, args, decoded.code);
+                throw cliError(decoded.code, 'extend-lock tx failed to submit', decoded.hint);
+            }
+            // markSubmitted BEFORE waitForReceipt — closes the retry-resend window.
+            if (this.idempotencyKey)
+                await markSubmitted(this.idempotencyKey, COMMAND, args, tx);
+            const receipt = await clients.publicClient.waitForTransactionReceipt({ hash: tx, timeout: 120_000 });
+            if (receipt.status === 'reverted') {
+                if (this.idempotencyKey)
+                    await markFailed(this.idempotencyKey, COMMAND, args, 'TX_REVERTED', tx);
+                throw cliError('TX_REVERTED', `extend-lock tx reverted: ${tx}`);
+            }
+            // Read the new state for the result payload.
+            const lockupAfter = await clients.publicClient.readContract({
+                address: vr.address, abi: vr.abi, functionName: 'lockupData', args: [lockupId],
+            });
+            const result = {
+                lockupId: lockupId.toString(),
+                durationAdded: duration.toString(),
+                txHash: tx,
+                block: receipt.blockNumber.toString(),
+                basescanUrl: cfg.network === 'mainnet'
+                    ? `https://basescan.org/tx/${tx}`
+                    : `https://sepolia.basescan.org/tx/${tx}`,
+                lockupBefore: {
+                    amount: lockupBefore[0].toString(),
+                    expiresAt: lockupBefore[1].toString(),
+                    votingPower: lockupBefore[3].toString(),
+                },
+                lockupAfter: {
+                    amount: lockupAfter[0].toString(),
+                    expiresAt: lockupAfter[1].toString(),
+                    votingPower: lockupAfter[3].toString(),
+                },
+            };
+            if (this.idempotencyKey)
+                await markConfirmed(this.idempotencyKey, COMMAND, args, result, tx);
+            emit(result, [
+                `✓ Extended lockup ${lockupId} by ${duration}s`,
+                `  expiresAt:   ${lockupBefore[1]} → ${lockupAfter[1]}`,
+                `  votingPower: ${lockupBefore[3]} → ${lockupAfter[3]}`,
+                `  tx: ${result.basescanUrl}`,
+                `  block: ${receipt.blockNumber}`,
+            ]);
+            return 0;
+        }
+        catch (err) {
+            this.handleError(err);
+        }
+    }
+}
+//# sourceMappingURL=extend-lock.js.map

package/dist/commands/extend-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-lock.js","sourceRoot":"","sources":["../../src/commands/extend-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE1G,MAAM,OAAO,GAAG,aAAa,CAAC;AAE9B,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,MAAM,CAAU,KAAK,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAE1C,MAAM,CAAU,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;QACxC,WAAW,EAAE,+DAA+D;QAC5E,QAAQ,EAAE;YACR,CAAC,0BAA0B;gBACzB,sCAAsC,CAAC;YACzC,CAAC,sBAAsB;gBACrB,oEAAoE,CAAC;YACvE,CAAC,yBAAyB;gBACxB,gDAAgD,CAAC;SACpD;KACF,CAAC,CAAC;IAEH,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC,CAAC;IACxG,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACpD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAE5C,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC;YAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,MAAM,QAAQ,CACZ,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,CAChC,CAAC;YACJ,CAAC;YAED,IAAI,QAAgB,CAAC;YACrB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,QAAQ,CAAC,mBAAmB,EAAE,kDAAkD,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;YAC3G,CAAC;YAED,IAAI,QAAgB,CAAC;YACrB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,QAAQ,CAAC,kBAAkB,EAAE,2DAA2D,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;YACnH,CAAC;YACD,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;gBACnB,MAAM,QAAQ,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAC;YACjF,CAAC;YAED,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;YAE9E,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAChD,CAAC;YACF,IAAI,QAAQ,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACzC,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,EAChE,CAAC,2BAA2B,QAAQ,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC3D,OAAO,CAAC,CAAC;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACzC,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,EAChE,CAAC,iDAAiD,QAAQ,CAAC,MAAM,IAAI,KAAK,EAAE;oBAC3E,sDAAsD,CAAC,CAAC,CAAC;gBAC5D,OAAO,CAAC,CAAC;YACX,CAAC;YAED,MAAM,OAAO,GAAG,aAAa,CAAC;gBAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,EAAE;gBACd,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAC,CAAC;YACH,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,gDAAgD;YAEjF,wBAAwB;YACxB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;gBACpD,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC;aAC5E,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBACZ,sDAAsD;gBACtD,MAAM,QAAQ,CACZ,kBAAkB,EAClB,UAAU,QAAQ,sBAAsB,GAAG,CAAC,OAAO,GAAG,EACtD,oFAAoF,CACrF,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAClE,MAAM,QAAQ,CACZ,kBAAkB,EAClB,UAAU,QAAQ,gBAAgB,KAAK,kCAAkC,OAAO,CAAC,OAAO,CAAC,OAAO,GAAG,EACnG,sGAAsG,CACvG,CAAC;YACJ,CAAC;YAED,8BAA8B;YAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACzC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;oBAChC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE;iBAC7E,CAAC;gBACF,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;oBAChC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE;iBAC7E,CAAC;aACH,CAAC,CAAC;YACH,IAAI,QAAQ,GAAG,MAAM,IAAI,QAAQ,GAAG,MAAM,EAAE,CAAC;gBAC3C,MAAM,QAAQ,CACZ,wBAAwB,EACxB,YAAY,QAAQ,mCAAmC,MAAM,KAAK,MAAM,IAAI,EAC5E,mDAAmD,MAAM,QAAQ,MAAM,GAAG,CAC3E,CAAC;YACJ,CAAC;YAED,0EAA0E;YAC1E,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;gBAC3D,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC;aAC/E,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC;oBACtD,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY;oBAC5D,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO;iBACrD,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACb,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;oBAChC,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACpE,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC;oBACH,SAAS,EAAE,IAAI;oBACf,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;oBAC7B,aAAa,EAAE,QAAQ,CAAC,QAAQ,EAAE;oBAClC,KAAK;oBACL,YAAY,EAAE;wBACZ,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;wBAClC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;wBACrC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;qBACxC;oBACD,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,IAAI;iBACzC,CAAC,CAAC;gBACH,OAAO,CAAC,CAAC;YACX,CAAC;YAED,IAAI,IAAI,CAAC,cAAc;gBAAE,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YAEzE,IAAI,EAAiB,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC7E,EAAE,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC;oBAC5C,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY;oBAC5D,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;oBAC1B,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK;iBACnE,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;gBAChC,IAAI,IAAI,CAAC,cAAc;oBAAE,MAAM,UAAU,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC5F,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,iCAAiC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAChF,CAAC;YAED,wEAAwE;YACxE,IAAI,IAAI,CAAC,cAAc;gBAAE,MAAM,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YAErF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACrG,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAClC,IAAI,IAAI,CAAC,cAAc;oBAAE,MAAM,UAAU,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;gBACjG,MAAM,QAAQ,CAAC,aAAa,EAAE,4BAA4B,EAAE,EAAE,CAAC,CAAC;YAClE,CAAC;YAED,6CAA6C;YAC7C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;gBAC1D,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC;aAC/E,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;gBAC7B,aAAa,EAAE,QAAQ,CAAC,QAAQ,EAAE;gBAClC,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE;gBACrC,WAAW,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS;oBACpC,CAAC,CAAC,2BAA2B,EAAE,EAAE;oBACjC,CAAC,CAAC,mCAAmC,EAAE,EAAE;gBAC3C,YAAY,EAAE;oBACZ,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;oBAClC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;oBACrC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACxC;gBACD,WAAW,EAAE;oBACX,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;oBACjC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;oBACpC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACvC;aACF,CAAC;YACF,IAAI,IAAI,CAAC,cAAc;gBAAE,MAAM,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAE7F,IAAI,CAAC,MAAM,EAAE;gBACX,qBAAqB,QAAQ,OAAO,QAAQ,GAAG;gBAC/C,kBAAkB,YAAY,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE;gBACvD,kBAAkB,YAAY,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE;gBACvD,SAAS,MAAM,CAAC,WAAW,EAAE;gBAC7B,YAAY,OAAO,CAAC,WAAW,EAAE;aAClC,CAAC,CAAC;YACH,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC"}

package/dist/commands/grant-access.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from './_base.js';
+export declare class GrantAccessCommand extends BaseCommand {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    datanet: string;
+    to: string | undefined;
+    idempotencyKey: string | undefined;
+    dryRun: boolean;
+    execute(): Promise<number>;
+}
+//# sourceMappingURL=grant-access.d.ts.map

package/dist/commands/grant-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant-access.d.ts","sourceRoot":"","sources":["../../src/commands/grant-access.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASzC,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,OAAgB,KAAK,aAAsB;IAE3C,OAAgB,KAAK,4BAYlB;IAEH,OAAO,SAAyG;IAChH,EAAE,qBAA6H;IAC/H,cAAc,qBAAsC;IACpD,MAAM,UAAsC;IAEtC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CA2KjC"}

package/dist/commands/grant-access.js

@@ -0,0 +1,191 @@
+/**
+ * `reppo grant-access --datanet <id> [--to <addr>]` — pay the REPPO
+ * access fee and grant `--to` access to the datanet. Defaults `--to`
+ * to the address derived from REPPO_PRIVATE_KEY.
+ *
+ * "Datanet" is the user-facing term; on-chain it's a "subnet" (the
+ * function is `accessSubnetWithREPPOFee` and we read `validSubnet` /
+ * `hasSubnetAccess` / `getAccessFeeREPPO`). The CLI surface translates.
+ *
+ * Pre-flight checks (all surface error codes BEFORE the cache write,
+ * so retries under the same --idempotency-key are safe):
+ *   1. validSubnet(datanetId)         → DATANET_NOT_FOUND
+ *   2. hasSubnetAccess(datanetId, to) → ACCESS_ALREADY_GRANTED (cheap savings)
+ *   3. getAccessFeeREPPO(datanetId)   → fee amount (also surfaced in the result)
+ *   4. REPPO balance >= fee           → INSUFFICIENT_REPPO_BALANCE
+ *   5. REPPO allowance(caller→sm) ≥   → INSUFFICIENT_ALLOWANCE (matches the
+ *      fee                             0xfb8f41b2 selector errors.ts decodes)
+ *
+ * Idempotency two-phase write protocol:
+ *   begin → submit tx → markSubmitted → wait receipt → markConfirmed
+ *
+ * Args fingerprint: { datanetId, to } — re-using one --idempotency-key
+ * for a different (datanetId, to) is rejected with IDEMPOTENCY_ARGS_MISMATCH.
+ */
+import { Option } from 'clipanion';
+import { formatUnits, isAddress } from 'viem';
+import { BaseCommand } from './_base.js';
+import { cliError, emit } from '../output/format.js';
+import { createClients, nextNonce } from '../chain/clients.js';
+import { subnetManager, reppoToken } from '../chain/contracts.js';
+import { decodeRevert } from '../chain/errors.js';
+import { begin, markSubmitted, markConfirmed, markFailed, peekIdempotent } from '../state/idempotency.js';
+const COMMAND = 'grant-access';
+export class GrantAccessCommand extends BaseCommand {
+    static paths = [['grant-access']];
+    static usage = BaseCommand.Usage({
+        description: 'Pay the REPPO access fee and grant a datanet access to an address.',
+        examples: [
+            ['Grant the wallet derived from REPPO_PRIVATE_KEY access to datanet 19',
+                'reppo grant-access --datanet 19'],
+            ['Grant a different address access',
+                'reppo grant-access --datanet 19 --to 0x726c…E31d'],
+            ['With idempotency key',
+                'reppo grant-access --datanet 19 --idempotency-key grant-19-self'],
+            ['Dry-run',
+                'reppo grant-access --datanet 19 --dry-run'],
+        ],
+    });
+    datanet = Option.String('--datanet', { required: true, description: 'Datanet (subnet) ID to grant access to' });
+    to = Option.String('--to', { description: 'Address to grant access to (defaults to address derived from REPPO_PRIVATE_KEY)' });
+    idempotencyKey = Option.String('--idempotency-key');
+    dryRun = Option.Boolean('--dry-run', false);
+    async execute() {
+        try {
+            const cfg = this.loadConfig();
+            const pk = cfg.privateKey;
+            if (!pk) {
+                throw cliError('MISSING_PRIVATE_KEY', 'No signing key available.', 'Set REPPO_PRIVATE_KEY in env.');
+            }
+            let datanetId;
+            try {
+                datanetId = BigInt(this.datanet);
+            }
+            catch {
+                throw cliError('INVALID_DATANET_ID', `Datanet id must be a non-negative integer; got "${this.datanet}".`);
+            }
+            const clients = createClients({
+                network: cfg.network,
+                privateKey: pk,
+                ...(cfg.rpcUrl ? { rpcUrl: cfg.rpcUrl } : {}),
+            });
+            const target = this.to
+                ? (isAddress(this.to)
+                    ? this.to
+                    : (() => { throw cliError('INVALID_ADDRESS', `Invalid --to address: ${this.to}`); })())
+                : clients.account.address;
+            const args = { datanetId: datanetId.toString(), to: target.toLowerCase() };
+            const decision = await peekIdempotent(this.idempotencyKey, COMMAND, args, this.dryRun);
+            if (decision.kind === 'return-confirmed') {
+                emit({ ...decision.result, idempotent: true, status: 'confirmed' }, [`(cached, confirmed) tx: ${decision.txHash ?? 'n/a'}`]);
+                return 0;
+            }
+            if (decision.kind === 'return-submitted') {
+                emit({ ...decision.result, idempotent: true, status: 'submitted' }, [`(cached, submitted but not confirmed yet) tx: ${decision.txHash ?? 'n/a'}`,
+                    `Re-run after the tx confirms, or check the explorer.`]);
+                return 0;
+            }
+            // Throwing variants — write commands must fail loud on TBD.
+            const sm = subnetManager(cfg.network);
+            const reppo = reppoToken(cfg.network);
+            // Pre-flight in parallel where independent.
+            const [valid, alreadyHasAccess, fee, balance, allowance] = await Promise.all([
+                clients.publicClient.readContract({
+                    address: sm.address, abi: sm.abi, functionName: 'validSubnet', args: [datanetId],
+                }),
+                clients.publicClient.readContract({
+                    address: sm.address, abi: sm.abi, functionName: 'hasSubnetAccess', args: [datanetId, target],
+                }),
+                clients.publicClient.readContract({
+                    address: sm.address, abi: sm.abi, functionName: 'getAccessFeeREPPO', args: [datanetId],
+                }),
+                clients.publicClient.readContract({
+                    address: reppo.address, abi: reppo.abi, functionName: 'balanceOf', args: [clients.account.address],
+                }),
+                clients.publicClient.readContract({
+                    address: reppo.address, abi: reppo.abi, functionName: 'allowance', args: [clients.account.address, sm.address],
+                }),
+            ]);
+            if (!valid) {
+                throw cliError('DATANET_NOT_FOUND', `Datanet ${datanetId} does not exist on ${cfg.network}.`, `Verify the id; check \`reppo query subnet ${datanetId}\` before granting access.`);
+            }
+            if (alreadyHasAccess) {
+                throw cliError('ACCESS_ALREADY_GRANTED', `${target} already has access to datanet ${datanetId}.`, 'Nothing to do — skip the call.');
+            }
+            if (balance < fee) {
+                throw cliError('INSUFFICIENT_REPPO_BALANCE', `Caller has ${formatUnits(balance, 18)} REPPO but the fee is ${formatUnits(fee, 18)} REPPO.`, 'Acquire more REPPO before granting access.');
+            }
+            if (allowance < fee) {
+                throw cliError('INSUFFICIENT_ALLOWANCE', `REPPO allowance from ${clients.account.address} to SubnetManager is ${formatUnits(allowance, 18)}, ` +
+                    `below the fee of ${formatUnits(fee, 18)} REPPO.`, `Approve the SubnetManager (${sm.address}) for at least ${formatUnits(fee, 18)} REPPO. ` +
+                    `Auto-approval lands in v0.2; for the alpha, send the approve() tx manually (e.g. via cast).`);
+            }
+            if (this.dryRun) {
+                const sim = await clients.publicClient.simulateContract({
+                    address: sm.address, abi: sm.abi, functionName: 'accessSubnetWithREPPOFee',
+                    args: [datanetId, target], account: clients.account,
+                }).catch((e) => {
+                    const decoded = decodeRevert(e);
+                    throw cliError(decoded.code, 'Simulation reverted', decoded.hint);
+                });
+                emit({
+                    simulated: true,
+                    datanetId: datanetId.toString(),
+                    to: target,
+                    feeREPPO: { raw: fee.toString(), formatted: formatUnits(fee, 18) },
+                    gas: sim.request.gas?.toString() ?? null,
+                });
+                return 0;
+            }
+            if (this.idempotencyKey)
+                await begin(this.idempotencyKey, COMMAND, args);
+            let tx;
+            try {
+                const nonce = await nextNonce(clients.publicClient, clients.account.address);
+                tx = await clients.walletClient.writeContract({
+                    address: sm.address, abi: sm.abi, functionName: 'accessSubnetWithREPPOFee',
+                    args: [datanetId, target],
+                    chain: clients.walletClient.chain, account: clients.account, nonce,
+                });
+            }
+            catch (e) {
+                const decoded = decodeRevert(e);
+                if (this.idempotencyKey)
+                    await markFailed(this.idempotencyKey, COMMAND, args, decoded.code);
+                throw cliError(decoded.code, 'grant-access tx failed to submit', decoded.hint);
+            }
+            // markSubmitted BEFORE waitForReceipt — closes the retry-resend window.
+            if (this.idempotencyKey)
+                await markSubmitted(this.idempotencyKey, COMMAND, args, tx);
+            const receipt = await clients.publicClient.waitForTransactionReceipt({ hash: tx, timeout: 120_000 });
+            if (receipt.status === 'reverted') {
+                if (this.idempotencyKey)
+                    await markFailed(this.idempotencyKey, COMMAND, args, 'TX_REVERTED', tx);
+                throw cliError('TX_REVERTED', `grant-access tx reverted: ${tx}`);
+            }
+            const result = {
+                txHash: tx,
+                datanetId: datanetId.toString(),
+                to: target,
+                feeREPPO: { raw: fee.toString(), formatted: formatUnits(fee, 18) },
+                block: receipt.blockNumber.toString(),
+                basescanUrl: cfg.network === 'mainnet'
+                    ? `https://basescan.org/tx/${tx}`
+                    : `https://sepolia.basescan.org/tx/${tx}`,
+            };
+            if (this.idempotencyKey)
+                await markConfirmed(this.idempotencyKey, COMMAND, args, result, tx);
+            emit(result, [
+                `✓ Granted ${target} access to datanet ${datanetId}`,
+                `  fee paid: ${formatUnits(fee, 18)} REPPO`,
+                `  tx: ${result.basescanUrl}`,
+                `  block: ${receipt.blockNumber}`,
+            ]);
+            return 0;
+        }
+        catch (err) {
+            this.handleError(err);
+        }
+    }
+}
+//# sourceMappingURL=grant-access.js.map