@chipi-stack/chipi-react 14.1.0 → 14.2.0

package/README.md

@@ -52,6 +52,15 @@ function Wallet() {
 }
 ```
 
+## What you can ship
+
+- **Crypto checkout components** — drop-in payment UIs for e-commerce and SaaS
+- **In-app token transfer UIs** — send and receive USDC with a few lines of React
+- **Connect-with-passkey flows** — biometric wallet login without seed phrases
+- **DeFi dashboards and loyalty/rewards redemption interfaces** — display balances, history, and reward claims
+
+Have an idea? [Tell us what you want to build](https://github.com/chipi-pay/build-with-chipi/issues/new)
+
 ## Documentation
 
 Full docs at [docs.chipipay.com](https://docs.chipipay.com)

package/dist/hooks.d.mts

@@ -1,4 +1,4 @@
-import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, Call, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
+import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, Call, SpendingPolicyConfig, SpendingPolicyData, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
 
@@ -363,11 +363,19 @@ interface UseChipiSessionReturn {
     clearSession: () => void;
     /** Refresh the on-chain session status */
     refetchStatus: () => Promise<void>;
+    /** Set a spending policy for the current session + token pair */
+    setSpendingPolicy: (config: Omit<SpendingPolicyConfig, "sessionPublicKey">) => Promise<string>;
+    /** Query the spending policy for a token (read-only, no gas) */
+    getSpendingPolicy: (token: string) => Promise<SpendingPolicyData>;
+    /** Remove a spending policy for a token */
+    removeSpendingPolicy: (token: string) => Promise<string>;
     isCreating: boolean;
     isRegistering: boolean;
     isRevoking: boolean;
     isExecuting: boolean;
     isLoadingStatus: boolean;
+    isSettingSpendingPolicy: boolean;
+    isRemovingSpendingPolicy: boolean;
     error: Error | null;
 }
 /**

package/dist/hooks.d.ts

@@ -1,4 +1,4 @@
-import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, Call, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
+import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, Call, SpendingPolicyConfig, SpendingPolicyData, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
 
@@ -363,11 +363,19 @@ interface UseChipiSessionReturn {
     clearSession: () => void;
     /** Refresh the on-chain session status */
     refetchStatus: () => Promise<void>;
+    /** Set a spending policy for the current session + token pair */
+    setSpendingPolicy: (config: Omit<SpendingPolicyConfig, "sessionPublicKey">) => Promise<string>;
+    /** Query the spending policy for a token (read-only, no gas) */
+    getSpendingPolicy: (token: string) => Promise<SpendingPolicyData>;
+    /** Remove a spending policy for a token */
+    removeSpendingPolicy: (token: string) => Promise<string>;
     isCreating: boolean;
     isRegistering: boolean;
     isRevoking: boolean;
     isExecuting: boolean;
     isLoadingStatus: boolean;
+    isSettingSpendingPolicy: boolean;
+    isRemovingSpendingPolicy: boolean;
     error: Error | null;
 }
 /**

package/dist/hooks.js

@@ -402,6 +402,61 @@ function useChipiSession(config) {
       setError(err);
     }
   });
+  const setSpendingPolicyMutation = reactQuery.useMutation({
+    mutationFn: async (policyConfig) => {
+      if (!wallet) throw new Error("Wallet is required");
+      if (!localSession)
+        throw new Error("No session to set policy on. Create and register a session first.");
+      if (!encryptKey) throw new Error("Encryption key (PIN) is required");
+      if (!supportsSession) throw new Error("Wallet does not support sessions");
+      const bearerToken = await getBearerToken();
+      if (!bearerToken) throw new Error("Bearer token is required");
+      const txHash = await chipiSDK.sessions.setSpendingPolicy(
+        {
+          encryptKey,
+          wallet,
+          spendingPolicyConfig: {
+            sessionPublicKey: localSession.publicKey,
+            ...policyConfig
+          }
+        },
+        bearerToken
+      );
+      return txHash;
+    },
+    onSuccess: () => {
+      setError(null);
+    },
+    onError: (err) => {
+      setError(err);
+    }
+  });
+  const removeSpendingPolicyMutation = reactQuery.useMutation({
+    mutationFn: async (token) => {
+      if (!wallet) throw new Error("Wallet is required");
+      if (!localSession) throw new Error("No session to remove policy from");
+      if (!encryptKey) throw new Error("Encryption key (PIN) is required");
+      if (!supportsSession) throw new Error("Wallet does not support sessions");
+      const bearerToken = await getBearerToken();
+      if (!bearerToken) throw new Error("Bearer token is required");
+      const txHash = await chipiSDK.sessions.removeSpendingPolicy(
+        {
+          encryptKey,
+          wallet,
+          sessionPublicKey: localSession.publicKey,
+          token
+        },
+        bearerToken
+      );
+      return txHash;
+    },
+    onSuccess: () => {
+      setError(null);
+    },
+    onError: (err) => {
+      setError(err);
+    }
+  });
   const createSession = react.useCallback(
     async (params) => {
       return createSessionMutation.mutateAsync(params ?? {});
@@ -430,14 +485,40 @@ function useChipiSession(config) {
   const refetchStatus = react.useCallback(async () => {
     await sessionStatusQuery.refetch();
   }, [sessionStatusQuery]);
+  const setSpendingPolicy = react.useCallback(
+    async (policyConfig) => {
+      return setSpendingPolicyMutation.mutateAsync(policyConfig);
+    },
+    [setSpendingPolicyMutation]
+  );
+  const getSpendingPolicy = react.useCallback(
+    async (token) => {
+      if (!wallet?.publicKey) throw new Error("Wallet is required");
+      if (!localSession?.publicKey) throw new Error("No session to query policy for");
+      return chipiSDK.sessions.getSpendingPolicy({
+        walletAddress: wallet.publicKey,
+        sessionPublicKey: localSession.publicKey,
+        token
+      });
+    },
+    [chipiSDK, wallet, localSession]
+  );
+  const removeSpendingPolicy = react.useCallback(
+    async (token) => {
+      return removeSpendingPolicyMutation.mutateAsync(token);
+    },
+    [removeSpendingPolicyMutation]
+  );
   const combinedError = react.useMemo(() => {
-    return error || createSessionMutation.error || registerSessionMutation.error || revokeSessionMutation.error || executeWithSessionMutation.error || sessionStatusQuery.error || null;
+    return error || createSessionMutation.error || registerSessionMutation.error || revokeSessionMutation.error || executeWithSessionMutation.error || setSpendingPolicyMutation.error || removeSpendingPolicyMutation.error || sessionStatusQuery.error || null;
   }, [
     error,
     createSessionMutation.error,
     registerSessionMutation.error,
     revokeSessionMutation.error,
     executeWithSessionMutation.error,
+    setSpendingPolicyMutation.error,
+    removeSpendingPolicyMutation.error,
     sessionStatusQuery.error
   ]);
   return {
@@ -456,12 +537,18 @@ function useChipiSession(config) {
     executeWithSession,
     clearSession,
     refetchStatus,
+    // Spending Policy Actions
+    setSpendingPolicy,
+    getSpendingPolicy,
+    removeSpendingPolicy,
     // Loading states
     isCreating: createSessionMutation.isPending,
     isRegistering: registerSessionMutation.isPending,
     isRevoking: revokeSessionMutation.isPending,
     isExecuting: executeWithSessionMutation.isPending,
     isLoadingStatus: sessionStatusQuery.isLoading,
+    isSettingSpendingPolicy: setSpendingPolicyMutation.isPending,
+    isRemovingSpendingPolicy: removeSpendingPolicyMutation.isPending,
     // Errors
     error: combinedError
   };