@tokenops/sdk 2.0.0-alpha.2 → 2.0.0-alpha.4

package/dist/core/pending.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Marks a write result returned before its transaction was observed executing, because the
+ * write was sent with `waitForReceipt: false` (a Safe / multisig signer whose submission is a
+ * `safeTxHash` that never mines until threshold owners co-sign).
+ *
+ * Every receipt-free result in the SDK extends this, and every mined counterpart extends
+ * {@link MinedWrite}, so one check narrows a result from any product:
+ *
+ * @example
+ * const result = await factory.createManager({ token, userSalt, waitForReceipt });
+ * if (result.pending) return trackSafeTx(result.hash);
+ * openManager(result.manager); // `Address`
+ *
+ * @public
+ */
+export interface PendingWrite {
+    /** The transaction has not been observed executing. */
+    pending: true;
+}
+/**
+ * The mined counterpart of {@link PendingWrite}: the receipt was read and every receipt-derived
+ * field is set. `pending` is never present; it is declared so `if (result.pending)` compiles on
+ * the union.
+ *
+ * @public
+ */
+export interface MinedWrite {
+    /** Never set on a mined result. */
+    pending?: never;
+}
+/**
+ * The `waitForReceipt` option of every receipt-free write. It is kept off the base `*Args`
+ * types, so a value typed as one of them still resolves to the mined overload; the methods
+ * take `Args & ReceiptMode<...>` instead.
+ *
+ * - `ReceiptMode<true>`: omitted or `true`. The SDK waits for the receipt and returns the
+ *   mined result ({@link MinedWrite}) with every receipt-derived field set.
+ * - `ReceiptMode<false>`: `false`, for a Safe / multisig signer whose submission returns a
+ *   `safeTxHash` that never mines until threshold owners co-sign. The call returns on
+ *   submission with a {@link PendingWrite} result; read the executed transaction's logs for
+ *   anything the receipt would have supplied.
+ * - `ReceiptMode` (`boolean`): a runtime value, as hooks and dynamic callers pass. The result
+ *   is the union of the two, narrowed by `pending`.
+ *
+ * @example
+ * async function deploy(args: CreateManagerArgs & ReceiptMode) {
+ *   const result = await factory.createManager(args);
+ *   return result.pending ? undefined : result.manager;
+ * }
+ *
+ * @public
+ */
+export type ReceiptMode<W extends boolean = boolean> = [W] extends [false] ? {
+    waitForReceipt: false;
+} : {
+    waitForReceipt?: W | undefined;
+};

package/dist/core/version.d.ts

@@ -12,4 +12,4 @@
  * Keep in sync with `package.json` via the `prepublishOnly` gate. If the two
  * drift, telemetry funnels will report a stale version.
  */
-export declare const SDK_VERSION = "1.0.0";
+export declare const SDK_VERSION = "2.0.0-alpha.4";

package/dist/fhe/operators.d.ts

@@ -73,9 +73,10 @@ export interface SetOperatorArgs {
     /** ERC-7984 token contract address. */
     token: Address;
     /**
-     * Address being authorized to pull tokens — typically a manager clone
-     * (`/fhe-vesting`), an airdrop clone (`/fhe-airdrop`), or the disperse
-     * singleton (`/fhe-disperse`).
+     * Address being authorized to pull tokens - typically a manager clone
+     * (`/fhe-vesting`), the airdrop FACTORY (`/fhe-airdrop`, which pulls the pool on
+     * every create-and-fund and `fundAirdrop`), or the disperse singleton
+     * (`/fhe-disperse`).
      */
     spender: Address;
     /**
@@ -147,7 +148,7 @@ export interface RevokeOperatorArgs {
     token: Address;
     /**
      * Address whose operator authorization should be revoked — typically a
-     * stale manager clone (`/fhe-vesting`), a closed airdrop clone
+     * stale manager clone (`/fhe-vesting`), a factory you no longer fund through
      * (`/fhe-airdrop`), or a singleton no longer in use (`/fhe-disperse`).
      */
     spender: Address;
@@ -208,7 +209,7 @@ export interface IsOperatorArgs {
     holder: Address;
     /**
      * Address whose operator status is being checked — typically a manager
-     * clone (`/fhe-vesting`), an airdrop clone/factory (`/fhe-airdrop`), or
+     * clone (`/fhe-vesting`), the airdrop factory (`/fhe-airdrop`), or
      * the disperse singleton (`/fhe-disperse`).
      */
     spender: Address;

package/dist/fhe/types.d.ts

@@ -36,7 +36,7 @@ export interface EncryptedInputs {
  * the contract emits `FHE.allow(handle, grantee)` (usually `msg.sender`) and the SDK extracts
  * `handle` from the receipt's ACL `Allowed` event.
  *
- * Pass `handle` to the Zama relayer's `userDecrypt` to obtain the plaintext — AS THE GRANTEE. Most entrypoints grant the caller, but not all: `MerkleAirdropClient.getClaimAmount` grants the entry's `account`, so a third-party submitter receives a valid handle it is not authorised to read.
+ * Pass `handle` to the Zama relayer's `userDecrypt` to obtain the plaintext - AS THE GRANTEE. Most entrypoints grant the caller, but not all: `MerkleAirdropClient.getClaimAmount` grants the entry's `account`, so a third-party sender (any address may submit a Merkle entry) receives a valid handle it is not authorised to read.
  * `hash` is the tx that committed the persistent ACL grant — surface it if
  * your UI needs to show the receipt.
  * @public

package/dist/fhe-airdrop/abis/airdrop-base.d.ts

@@ -31,6 +31,10 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     readonly inputs: readonly [];
     readonly name: "ClaimsPaused";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "ClawbackRequiresPause";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [];
     readonly name: "EmptyBatch";
@@ -115,6 +119,10 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     readonly inputs: readonly [];
     readonly name: "LastFeeCollector";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "NativeRescueRequiresZeroFee";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [];
     readonly name: "TokenNotAWrapper";
@@ -123,6 +131,10 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     readonly inputs: readonly [];
     readonly name: "TokenNotUnwrappable";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "UninitializedHandle";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [];
     readonly name: "ZeroAdminGrant";
@@ -151,6 +163,10 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     readonly inputs: readonly [];
     readonly name: "ZeroToken";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "ZeroUnwrapRequestId";
+    readonly type: "error";
 }, {
     readonly anonymous: false;
     readonly inputs: readonly [{
@@ -176,8 +192,33 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     }, {
         readonly indexed: false;
         readonly internalType: "uint256";
-        readonly name: "deploymentBlockNumber";
+        readonly name: "gasFee";
         readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint32";
+        readonly name: "startTime";
+        readonly type: "uint32";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint32";
+        readonly name: "endTime";
+        readonly type: "uint32";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bool";
+        readonly name: "canExtendClaimWindow";
+        readonly type: "bool";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bool";
+        readonly name: "unwrappable";
+        readonly type: "bool";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "complianceManager";
+        readonly type: "address";
     }];
     readonly name: "AirdropInitialized";
     readonly type: "event";
@@ -311,6 +352,21 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     }];
     readonly name: "HandleDisclosedToParty";
     readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "NativeTokenRescued";
+    readonly type: "event";
 }, {
     readonly anonymous: false;
     readonly inputs: readonly [{
@@ -458,6 +514,16 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "canExtendClaimWindow";
+    readonly outputs: readonly [{
+        readonly internalType: "bool";
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [];
     readonly name: "complianceManager";
@@ -468,6 +534,16 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "deploymentBlockNumber";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "euint64";
@@ -548,6 +624,16 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "refreshComplianceBalance";
+    readonly outputs: readonly [{
+        readonly internalType: "euint64";
+        readonly name: "balance";
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "address";
@@ -562,6 +648,16 @@ export declare const confidentialAirdropBaseAbi: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "recipient";
+        readonly type: "address";
+    }];
+    readonly name: "rescueNativeToken";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "address";

package/dist/fhe-airdrop/abis/ecdsa.d.ts

@@ -59,6 +59,10 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     readonly inputs: readonly [];
     readonly name: "ClaimsPaused";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "ClawbackRequiresPause";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [];
     readonly name: "DedupIdAlreadyClaimed";
@@ -179,6 +183,10 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     readonly inputs: readonly [];
     readonly name: "LastFeeCollector";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "NativeRescueRequiresZeroFee";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [];
     readonly name: "NotInitializing";
@@ -243,6 +251,10 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     }];
     readonly name: "UUPSUnsupportedProxiableUUID";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "UninitializedHandle";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [];
     readonly name: "ZamaProtocolUnsupported";
@@ -279,6 +291,10 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     readonly inputs: readonly [];
     readonly name: "ZeroToken";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "ZeroUnwrapRequestId";
+    readonly type: "error";
 }, {
     readonly anonymous: false;
     readonly inputs: readonly [{
@@ -304,8 +320,33 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     }, {
         readonly indexed: false;
         readonly internalType: "uint256";
-        readonly name: "deploymentBlockNumber";
+        readonly name: "gasFee";
         readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint32";
+        readonly name: "startTime";
+        readonly type: "uint32";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint32";
+        readonly name: "endTime";
+        readonly type: "uint32";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bool";
+        readonly name: "canExtendClaimWindow";
+        readonly type: "bool";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bool";
+        readonly name: "unwrappable";
+        readonly type: "bool";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "complianceManager";
+        readonly type: "address";
     }];
     readonly name: "AirdropInitialized";
     readonly type: "event";
@@ -404,6 +445,16 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     }];
     readonly name: "ComplianceBalanceDisclosed";
     readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: false;
+        readonly internalType: "enum IECDSAConfidentialAirdropTypes.DedupMode";
+        readonly name: "dedupMode";
+        readonly type: "uint8";
+    }];
+    readonly name: "ECDSAAirdropInitialized";
+    readonly type: "event";
 }, {
     readonly anonymous: false;
     readonly inputs: readonly [];
@@ -454,6 +505,21 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     }];
     readonly name: "Initialized";
     readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "NativeTokenRescued";
+    readonly type: "event";
 }, {
     readonly anonymous: false;
     readonly inputs: readonly [{
@@ -741,6 +807,16 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "canExtendClaimWindow";
+    readonly outputs: readonly [{
+        readonly internalType: "bool";
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "address";
@@ -819,6 +895,26 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "dedupMode";
+    readonly outputs: readonly [{
+        readonly internalType: "enum IECDSAConfidentialAirdropTypes.DedupMode";
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "deploymentBlockNumber";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "euint64";
@@ -1169,6 +1265,16 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "refreshComplianceBalance";
+    readonly outputs: readonly [{
+        readonly internalType: "euint64";
+        readonly name: "balance";
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "bytes32";
@@ -1197,6 +1303,16 @@ export declare const ecdsaConfidentialAirdropAbi: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "recipient";
+        readonly type: "address";
+    }];
+    readonly name: "rescueNativeToken";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "address";