@chipi-stack/backend 14.11.0 → 14.12.1

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { shortString, hash, CallData, ec, RpcProvider, Account, num, CairoCustomEnum, CairoOption, CairoOptionVariant, cairo, typedData, uint256 } from 'starknet';
-import { SHHH_KIND_GAS_OVERHEAD, isValidApiKey, ChipiAuthError, STARKNET_NETWORKS, API_VERSIONING, validateErrorResponse, ChipiApiError, handleApiError, getWalletTypeFromClassHash, WALLET_CLASS_HASHES, WALLET_RPC_ENDPOINTS, SHHH_VERIFIER_CLASS_HASHES, API_ENDPOINTS, ChipiTransactionError, formatAmount, SKU_CONTRACTS, CARRIER_IDS, SERVICE_TYPES, ChipiSessionError, SESSION_ERRORS, SESSION_DEFAULTS, SESSION_ENTRYPOINTS, CONTRACT_ADDRESSES, TOKEN_DECIMALS } from '@chipi-stack/shared';
+import { SHHH_KIND_GAS_OVERHEAD, isValidApiKey, ChipiAuthError, STARKNET_NETWORKS, API_VERSIONING, validateErrorResponse, ChipiApiError, handleApiError, getWalletTypeFromClassHash, WALLET_CLASS_HASHES, WALLET_RPC_ENDPOINTS, SHHH_VERIFIER_CLASS_HASHES, API_ENDPOINTS, ChipiTransactionError, formatAmount, SKU_CONTRACTS, CARRIER_IDS, SERVICE_TYPES, ChipiSessionError, SESSION_ERRORS, SESSION_DEFAULTS, SESSION_ENTRYPOINTS, withRpcFallback, CONTRACT_ADDRESSES, TOKEN_DECIMALS } from '@chipi-stack/shared';
 import CryptoES from 'crypto-es';
 import { randomBytes } from 'crypto';
 import { STARKNET_CONTRACTS, Chain } from '@chipi-stack/types';
@@ -961,8 +961,10 @@ var executePaymasterTransaction = async ({
     let walletType = wallet.walletType ?? "READY";
     if (!wallet.walletType) {
       try {
-        const resolveProvider = new RpcProvider({ nodeUrl: WALLET_RPC_ENDPOINTS.CHIPI });
-        const onChainClassHash = await resolveProvider.getClassHashAt(wallet.publicKey, "latest");
+        const onChainClassHash = await withRpcFallback(
+          (provider2) => provider2.getClassHashAt(wallet.publicKey, "latest"),
+          { fallbackUrl: WALLET_RPC_ENDPOINTS.CHIPI }
+        );
         walletType = getWalletTypeFromClassHash(onChainClassHash) ?? "READY";
       } catch {
       }
@@ -2387,18 +2389,18 @@ var ChipiSessions = class {
   async getSessionData(params) {
     const { walletAddress, sessionPublicKey } = params;
     try {
-      const provider = new RpcProvider({
-        nodeUrl: WALLET_RPC_ENDPOINTS["CHIPI"]
-      });
       console.log("[ChipiSDK:Session:GetData] Querying session data", {
         walletAddress: walletAddress.slice(0, 15) + "...",
         sessionPubKey: sessionPublicKey.slice(0, 15) + "..."
       });
-      const result = await provider.callContract({
-        contractAddress: walletAddress,
-        entrypoint: SESSION_ENTRYPOINTS.GET_DATA,
-        calldata: [sessionPublicKey]
-      });
+      const result = await withRpcFallback(
+        (provider) => provider.callContract({
+          contractAddress: walletAddress,
+          entrypoint: SESSION_ENTRYPOINTS.GET_DATA,
+          calldata: [sessionPublicKey]
+        }),
+        { fallbackUrl: WALLET_RPC_ENDPOINTS["CHIPI"] }
+      );
       const resultArray = Array.isArray(result) ? result : result.result || [];
       if (resultArray.length < 4) {
         console.warn("[ChipiSDK:Session:GetData] Unexpected response format", {
@@ -2469,7 +2471,9 @@ var ChipiSessions = class {
    * 1. Generated via `createSessionKey()`
    * 2. Registered on-chain via `addSessionKeyToContract()`
    *
-   * CHIPI wallets only - will throw if wallet type is not CHIPI.
+   * CHIPI v29 and SHHH V8.4 only: both embed the SNIP-163 sessions
+   * component. Throws for any other wallet type, notably READY (Argent X),
+   * which does not. See `validateWalletSupportsSessions`.
    *
    * @param params - Session execution parameters
    * @param bearerToken - Authentication token
@@ -2685,19 +2689,19 @@ var ChipiSessions = class {
   async getSpendingPolicy(params) {
     const { walletAddress, sessionPublicKey, token } = params;
     try {
-      const provider = new RpcProvider({
-        nodeUrl: WALLET_RPC_ENDPOINTS["CHIPI"]
-      });
       console.log("[ChipiSDK:Session:GetSpendingPolicy] Querying spending policy", {
         walletAddress: walletAddress.slice(0, 15) + "...",
         sessionPubKey: sessionPublicKey.slice(0, 15) + "...",
         token: token.slice(0, 15) + "..."
       });
-      const result = await provider.callContract({
-        contractAddress: walletAddress,
-        entrypoint: SESSION_ENTRYPOINTS.GET_SPENDING_POLICY,
-        calldata: [sessionPublicKey, token]
-      });
+      const result = await withRpcFallback(
+        (provider) => provider.callContract({
+          contractAddress: walletAddress,
+          entrypoint: SESSION_ENTRYPOINTS.GET_SPENDING_POLICY,
+          calldata: [sessionPublicKey, token]
+        }),
+        { fallbackUrl: WALLET_RPC_ENDPOINTS["CHIPI"] }
+      );
       const resultArray = Array.isArray(result) ? result : result.result || [];
       if (resultArray.length < 8) {
         console.warn("[ChipiSDK:Session:GetSpendingPolicy] Unexpected response format", {
@@ -2894,6 +2898,47 @@ var ChipiTreasury = class {
     });
     return { ...res, items: res.items ?? [] };
   }
+  /**
+   * Read a treasury's risk-tier quorum policy (`sk_`).
+   */
+  async getPolicy(treasuryId, options = {}) {
+    return this.client.get({
+      endpoint: `${API_ENDPOINTS.TREASURIES}/${treasuryId}/policy`,
+      bearerToken: this.secret(options.bearerToken)
+    });
+  }
+  /**
+   * Set a treasury's risk-tier quorums (`sk_`).
+   *
+   * An omitted tier is left unchanged; passing `null` clears it. Configuring
+   * this used to require the dashboard, so an integrator driving governance
+   * from their own server could see a quorum applied to a proposal but never
+   * choose it.
+   *
+   * IMPORTANT: a quorum can only RAISE `requiredApprovals` above the wallet's
+   * on-chain threshold. The chain is the hard floor, so a quorum set below it
+   * produces proposals that reach `APPROVED` here and then revert at execute.
+   *
+   * Server-only: it needs a `sk_`.
+   *
+   * @example
+   * ```typescript
+   * // Founding a pool and borrowing need 3 owners; repaying needs the
+   * // wallet's own threshold.
+   * await sdk.treasury.setPolicy(treasuryId, { sensitiveQuorum: 3 });
+   * ```
+   */
+  async setPolicy(treasuryId, options = {}) {
+    const { routineQuorum, sensitiveQuorum, bearerToken } = options;
+    const body = {};
+    if (routineQuorum !== void 0) body.routineQuorum = routineQuorum;
+    if (sensitiveQuorum !== void 0) body.sensitiveQuorum = sensitiveQuorum;
+    return this.client.patch({
+      endpoint: `${API_ENDPOINTS.TREASURIES}/${treasuryId}/policy`,
+      bearerToken: this.secret(bearerToken),
+      body
+    });
+  }
   /**
    * Build a {@link TreasuryTransport} for one treasury + owner. Wire the
    * returned object directly into chipi-react's `useProposeAction` /
@@ -3578,6 +3623,49 @@ var ChipiBrowserSDK = class extends ChipiSDK {
   // All methods are inherited from ChipiSDK
   // bearerToken parameter is required for each authenticated request
 };
+var DEFAULT_RETRY_INTERVAL_MS = 3e3;
+var DEFAULT_TIMEOUT_MS = 3e5;
+function isPending(finalityStatus) {
+  return finalityStatus === void 0 || finalityStatus === "RECEIVED" || finalityStatus === "PENDING" || finalityStatus === "PRE_CONFIRMED";
+}
+async function waitForTransaction(transactionHash, options = {}) {
+  const {
+    nodeUrl = WALLET_RPC_ENDPOINTS.CHIPI,
+    retryIntervalMs = DEFAULT_RETRY_INTERVAL_MS,
+    timeoutMs = DEFAULT_TIMEOUT_MS
+  } = options;
+  const deadline = Date.now() + timeoutMs;
+  let lastError;
+  for (; ; ) {
+    try {
+      const receipt = await withRpcFallback(
+        (provider) => provider.getTransactionReceipt(transactionHash),
+        { fallbackUrl: nodeUrl }
+      );
+      if (!isPending(receipt?.finality_status)) {
+        const reverted = receipt.execution_status === "REVERTED";
+        return {
+          transactionHash,
+          success: !reverted,
+          executionStatus: receipt.execution_status,
+          finalityStatus: receipt.finality_status,
+          ...reverted ? { revertReason: receipt.revert_reason ?? "reverted on chain" } : {},
+          events: receipt.events ?? [],
+          ...receipt.block_number !== void 0 ? { blockNumber: receipt.block_number } : {}
+        };
+      }
+    } catch (err) {
+      lastError = err;
+    }
+    if (Date.now() + retryIntervalMs >= deadline) {
+      const detail = lastError instanceof Error ? `: ${lastError.message}` : "";
+      throw new Error(
+        `Timed out after ${timeoutMs}ms waiting for ${transactionHash}${detail}. The transaction may still land; re-check before treating it as failed.`
+      );
+    }
+    await new Promise((resolve) => setTimeout(resolve, retryIntervalMs));
+  }
+}
 
 // src/index.ts
 init_encryption2();
@@ -4800,6 +4888,6 @@ function submitViaAccount(funded) {
   };
 }
 
-export { ANY_CALLER_FELT, APPLE_ISSUER, BOOTSTRAP_DOMAIN_SEPARATOR, ChipiBrowserSDK, ChipiClient, ChipiPaymasterAdapter, ChipiSDK, ChipiServerSDK, ChipiSessions, ChipiSkuPurchases, ChipiSkus, ChipiTransactions, ChipiTreasury, ChipiWallets, DEFAULT_OP_EXPIRY_SECONDS, ISIGNER_CANONICAL_LABEL, ISIGNER_ID, ISRC9_V2_ID, MAX_OE_VALIDITY_WINDOW_SECONDS, MIN_THRESHOLD_OWNERS, OE_DOMAIN_NAME, OE_DOMAIN_REVISION, OE_DOMAIN_VERSION, OP_ADD_OWNER, OP_REMOVE_OWNER, OP_ROTATE_OWNER, OP_SET_THRESHOLD, ROLE_GUARDIAN, ROLE_OWNER, SIG_VERSION_V1_HEX_ASCII, SIG_VERSION_V2_SNIP12, SIG_VERSION_V2_THRESHOLD, STARKNET_MESSAGE_PREFIX, ShhhAccount, TIMELOCK_SECONDS, VIEW_SELECTORS, X402Facilitator, X402ShhhClient, assertValidV2Snip12Envelope, buildBootstrapSignedCall, buildCancelPendingOpCall, buildCancelRecoveryCall, buildEd25519Envelope, buildEd25519EnvelopeFromSignature, buildEip191EnvelopeFromPrivateKey, buildEip191EnvelopeFromSignature, buildExecuteAddOwnerCall, buildExecuteRemoveOwnerCall, buildExecuteRotateOwnerCall, buildExecuteSetThresholdCall, buildFinalizeRecoveryCall, buildInitiateRecoveryCall, buildJwtAppleSubEnvelopeFromTestKey, buildJwtAppleSubEnvelopeFromTokenResponse, buildMigrationCalls, buildOutsideExecution, buildProposeAddOwnerCall, buildProposeRemoveOwnerCall, buildProposeRotateOwnerCall, buildProposeSetThresholdCall, buildStarkEnvelope, buildThresholdEnvelope, buildWebAuthnEnvelopeFromAssertion, buildWebAuthnEnvelopeFromPrivateKey, byteArrayToFelts, computeAddressSalt, computeBootstrapMessage, computeISignerId, computeOeHash, computeShhhAddress, computeSnip12Hash, decryptPrivateKey, ed25519OwnerId, ed25519OwnerPubkeyParam, ed25519PubkeyFelts, ed25519SignedBytes, eip191OwnerId, eip191OwnerPubkeyParam, eip191PubkeyFelts, encryptPrivateKey, estimateThresholdGasOverhead, executeShhhSponsoredRaw, hashCall, hashCalls, hashOutsideExecutionStruct, hashStarknetDomain, isReadyToExecute, jwtAppleSubHash, jwtAppleSubOwnerId, jwtAppleSubPubkeyFelts, labelToFelt, locateSubClaim, messageHashToNonceB64url, migrateChipiWalletToShhh, ownerCommitment, parseAppleIdToken, parseDerEcdsaSignature, parseEip191Signature, parseThresholdEnvelope, resolveShhhChainId, secondsUntilExecutable, serializeExecuteFromOutsideV2Calldata, signBootstrapMessage, signTypedData, signTypedDataArray, snip12HashToHexAsciiBytes, starkOwnerId, starkPubkeyFelts, submitViaAccount, webauthnOwnerId, webauthnOwnerPubkeyParam, webauthnPubkeyFelts, wrapV2Snip12Envelope, wrapV2ThresholdEnvelope, x402Middleware };
+export { ANY_CALLER_FELT, APPLE_ISSUER, BOOTSTRAP_DOMAIN_SEPARATOR, ChipiBrowserSDK, ChipiClient, ChipiPaymasterAdapter, ChipiSDK, ChipiServerSDK, ChipiSessions, ChipiSkuPurchases, ChipiSkus, ChipiTransactions, ChipiTreasury, ChipiWallets, DEFAULT_OP_EXPIRY_SECONDS, ISIGNER_CANONICAL_LABEL, ISIGNER_ID, ISRC9_V2_ID, MAX_OE_VALIDITY_WINDOW_SECONDS, MIN_THRESHOLD_OWNERS, OE_DOMAIN_NAME, OE_DOMAIN_REVISION, OE_DOMAIN_VERSION, OP_ADD_OWNER, OP_REMOVE_OWNER, OP_ROTATE_OWNER, OP_SET_THRESHOLD, ROLE_GUARDIAN, ROLE_OWNER, SIG_VERSION_V1_HEX_ASCII, SIG_VERSION_V2_SNIP12, SIG_VERSION_V2_THRESHOLD, STARKNET_MESSAGE_PREFIX, ShhhAccount, TIMELOCK_SECONDS, VIEW_SELECTORS, X402Facilitator, X402ShhhClient, assertValidV2Snip12Envelope, buildBootstrapSignedCall, buildCancelPendingOpCall, buildCancelRecoveryCall, buildEd25519Envelope, buildEd25519EnvelopeFromSignature, buildEip191EnvelopeFromPrivateKey, buildEip191EnvelopeFromSignature, buildExecuteAddOwnerCall, buildExecuteRemoveOwnerCall, buildExecuteRotateOwnerCall, buildExecuteSetThresholdCall, buildFinalizeRecoveryCall, buildInitiateRecoveryCall, buildJwtAppleSubEnvelopeFromTestKey, buildJwtAppleSubEnvelopeFromTokenResponse, buildMigrationCalls, buildOutsideExecution, buildProposeAddOwnerCall, buildProposeRemoveOwnerCall, buildProposeRotateOwnerCall, buildProposeSetThresholdCall, buildStarkEnvelope, buildThresholdEnvelope, buildWebAuthnEnvelopeFromAssertion, buildWebAuthnEnvelopeFromPrivateKey, byteArrayToFelts, computeAddressSalt, computeBootstrapMessage, computeISignerId, computeOeHash, computeShhhAddress, computeSnip12Hash, decryptPrivateKey, ed25519OwnerId, ed25519OwnerPubkeyParam, ed25519PubkeyFelts, ed25519SignedBytes, eip191OwnerId, eip191OwnerPubkeyParam, eip191PubkeyFelts, encryptPrivateKey, estimateThresholdGasOverhead, executeShhhSponsoredRaw, hashCall, hashCalls, hashOutsideExecutionStruct, hashStarknetDomain, isReadyToExecute, jwtAppleSubHash, jwtAppleSubOwnerId, jwtAppleSubPubkeyFelts, labelToFelt, locateSubClaim, messageHashToNonceB64url, migrateChipiWalletToShhh, ownerCommitment, parseAppleIdToken, parseDerEcdsaSignature, parseEip191Signature, parseThresholdEnvelope, resolveShhhChainId, secondsUntilExecutable, serializeExecuteFromOutsideV2Calldata, signBootstrapMessage, signTypedData, signTypedDataArray, snip12HashToHexAsciiBytes, starkOwnerId, starkPubkeyFelts, submitViaAccount, waitForTransaction, webauthnOwnerId, webauthnOwnerPubkeyParam, webauthnPubkeyFelts, wrapV2Snip12Envelope, wrapV2ThresholdEnvelope, x402Middleware };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map