@startale/app-sdk 1.0.0

package/dist/interface/public-utilities/spend-permission/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/interface/public-utilities/spend-permission/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qCAAqC,CAAA"}

package/dist/interface/public-utilities/spend-permission/index.js

@@ -0,0 +1,8 @@
+export * from './methods/fetchPermissions.js';
+export * from './methods/getHash.js';
+export * from './methods/getPermissionStatus.js';
+export * from './methods/prepareRevokeCallData.js';
+export * from './methods/prepareSpendCallData.js';
+export * from './methods/requestRevoke.js';
+export * from './methods/requestSpendPermission.js';
+//# sourceMappingURL=index.js.map

package/dist/interface/public-utilities/spend-permission/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/interface/public-utilities/spend-permission/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qCAAqC,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/fetchPermissions.d.ts

@@ -0,0 +1,14 @@
+import { ProviderInterface } from '../../../../core/provider/interface.js';
+import { SpendPermission } from '../../../../core/rpc/coinbase_fetchSpendPermissions.js';
+type FetchPermissionsType = {
+    account: string;
+    chainId: number;
+    spender: string;
+};
+export declare const fetchPermissions: (({ provider, account, chainId, spender, }: FetchPermissionsType & {
+    provider: ProviderInterface;
+}) => Promise<SpendPermission[]>) | ((args_0: FetchPermissionsType & {
+    provider: ProviderInterface;
+}) => Promise<SpendPermission[]>);
+export {};
+//# sourceMappingURL=fetchPermissions.d.ts.map

package/dist/interface/public-utilities/spend-permission/methods/fetchPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchPermissions.d.ts","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/fetchPermissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAEN,eAAe,EACf,MAAM,6CAA6C,CAAA;AAGpD,KAAK,oBAAoB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AA4DD,eAAO,MAAM,gBAAgB,8CAjB1B,oBAAoB,GAAG;IAAE,QAAQ,EAAE,iBAAiB,CAAA;CAAE,KAAG,OAAO,CAClE,eAAe,EAAE,CACjB;cAFqC,iBAAiB;iCAiBU,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/fetchPermissions.js

@@ -0,0 +1,52 @@
+import { withTelemetry } from '../withTelemetry.js';
+/**
+ * Fetches existing spend permissions for a specific account, spender, and chain.
+ *
+ * This helper method retrieves all spend permissions that have been granted by a specific
+ * account to a specific spender on a given chain. This is useful for checking existing
+ * permissions before creating new ones, or for displaying current allowances to users.
+ *
+ * The method uses the coinbase_fetchPermissions RPC method to query the permissions
+ * from the backend service.
+ *
+ * @param params - The parameters for the fetchPermissions method.
+ * @param params.provider - The provider interface used to make the coinbase_fetchPermissions request.
+ * @param params.account - The account to fetch permissions for.
+ * @param params.chainId - The chain ID to fetch permissions for.
+ * @param params.spender - The spender to fetch permissions for.
+ *
+ * @returns A promise that resolves to an array of SpendPermission objects.
+ *
+ * @example
+ * ```typescript
+ * import { fetchPermissions } from '@startale/app-sdk/spend-permission';
+ *
+ * // Fetch all permissions for an account-spender pair
+ * const permissions = await fetchPermissions({
+ *   provider, // Base Account Provider
+ *   account: '0x1234...',
+ *   spender: '0x5678...',
+ *   chainId: 8453 // Base mainnet
+ * });
+ *
+ * console.log(`Found ${permissions.length} permissions`);
+ * permissions.forEach(permission => {
+ *   console.log(`Token: ${permission.permission.token}`);
+ * });
+ * ```
+ */
+const fetchPermissionsFn = async ({ provider, account, chainId, spender, }) => {
+    const response = (await provider.request({
+        method: 'coinbase_fetchPermissions',
+        params: [
+            {
+                account,
+                chainId: `0x${chainId.toString(16)}`,
+                spender,
+            },
+        ],
+    }));
+    return response.permissions;
+};
+export const fetchPermissions = withTelemetry(fetchPermissionsFn);
+//# sourceMappingURL=fetchPermissions.js.map

package/dist/interface/public-utilities/spend-permission/methods/fetchPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchPermissions.js","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/fetchPermissions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAQnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,kBAAkB,GAAG,KAAK,EAAE,EACjC,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,GACiD,EAEvD,EAAE;IACH,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC;QACxC,MAAM,EAAE,2BAA2B;QACnC,MAAM,EAAE;YACP;gBACC,OAAO;gBACP,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;gBACpC,OAAO;aACP;SACD;KACD,CAAC,CAA6B,CAAA;IAE/B,OAAO,QAAQ,CAAC,WAAW,CAAA;AAC5B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/getHash.d.ts

@@ -0,0 +1,9 @@
+import { SpendPermissionTypedData } from '../utils.js';
+export declare const getHash: (({ permission, chainId, }: {
+    permission: SpendPermissionTypedData["message"];
+    chainId: number;
+}) => Promise<`0x${string}`>) | ((args_0: {
+    permission: SpendPermissionTypedData["message"];
+    chainId: number;
+}) => Promise<`0x${string}`>);
+//# sourceMappingURL=getHash.d.ts.map

package/dist/interface/public-utilities/spend-permission/methods/getHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHash.d.ts","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/getHash.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAoEtD,eAAO,MAAM,OAAO,8BA5BjB;IACF,UAAU,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAA;IAC/C,OAAO,EAAE,MAAM,CAAA;CACf,KAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;gBAFb,wBAAwB,CAAC,SAAS,CAAC;aACtC,MAAM;6BA0B+B,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/getHash.js

@@ -0,0 +1,54 @@
+import { spendPermissionManagerAbi, spendPermissionManagerAddress, } from '../../../../sign/app-sdk/utils/constants.js';
+import { getClient } from '../../../../store/chain-clients/utils.js';
+import { readContract } from 'viem/actions';
+import { withTelemetry } from '../withTelemetry.js';
+/**
+ * Gets the hash of a spend permission from the SpendPermissionManager contract.
+ *
+ * This function calls the getHash method on the SpendPermissionManager contract
+ * to compute the unique hash for a given spend permission. This hash can be used
+ * to identify the permission on-chain.
+ *
+ * @param params - The parameters for the getHash method.
+ * @param params.permission - The spend permission message object from the typed data that
+ * contains all permission details.
+ * @param params.chainId - The chain ID to use for the contract call
+ *
+ * @returns A promise that resolves to the permission hash as a hex string
+ *
+ * @example
+ * ```typescript
+ * import { getHash } from '@startale/app-sdk/spend-permission';
+ *
+ * const permission = {
+ *   account: '0x1234...',
+ *   spender: '0x5678...',
+ *   token: '0xabcd...',
+ *   allowance: '1000000', // 1 USDC (6 decimals)
+ *   period: 86400 * 30, // 30 days in seconds
+ *   start: Date.now(),
+ *   end: Date.now() + (86400 * 365),
+ *   salt: '0x1234567890abcdef...',
+ *   extraData: '0x'
+ * };
+ *
+ * const hash = await getHash(permission, 8453); // Base mainnet
+ * console.log('Permission hash:', hash);
+ * ```
+ */
+const getHashFn = async ({ permission, chainId, }) => {
+    const client = getClient(chainId);
+    if (!client) {
+        throw new Error(`No client found for chain ID ${chainId}. Please ensure SDK is in connected state`);
+    }
+    const spendPermissionArgs = Object.assign(Object.assign({}, permission), { allowance: BigInt(permission.allowance), salt: BigInt(permission.salt) });
+    const hash = await readContract(client, {
+        address: spendPermissionManagerAddress,
+        abi: spendPermissionManagerAbi,
+        functionName: 'getHash',
+        args: [spendPermissionArgs],
+    });
+    return hash;
+};
+export const getHash = withTelemetry(getHashFn);
+//# sourceMappingURL=getHash.js.map

package/dist/interface/public-utilities/spend-permission/methods/getHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHash.js","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/getHash.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,yBAAyB,EACzB,6BAA6B,GAC7B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,SAAS,GAAG,KAAK,EAAE,EACxB,UAAU,EACV,OAAO,GAIP,EAA0B,EAAE;IAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAEjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,gCAAgC,OAAO,2CAA2C,CAClF,CAAA;IACF,CAAC;IAED,MAAM,mBAAmB,mCACrB,UAAU,KACb,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EACvC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAC7B,CAAA;IAED,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACvC,OAAO,EAAE,6BAA6B;QACtC,GAAG,EAAE,yBAAyB;QAC9B,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE,CAAC,mBAAmB,CAAC;KAC3B,CAAC,CAAA;IAEF,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/getPermissionStatus.d.ts

@@ -0,0 +1,8 @@
+import { SpendPermission } from '../../../../core/rpc/coinbase_fetchSpendPermissions.js';
+export type GetPermissionStatusResponseType = {
+    remainingSpend: bigint;
+    nextPeriodStart: Date;
+    isActive: boolean;
+};
+export declare const getPermissionStatus: ((permission: SpendPermission) => Promise<GetPermissionStatusResponseType>) | ((permission: SpendPermission) => Promise<GetPermissionStatusResponseType>);
+//# sourceMappingURL=getPermissionStatus.d.ts.map

package/dist/interface/public-utilities/spend-permission/methods/getPermissionStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPermissionStatus.d.ts","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/getPermissionStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAU7E,MAAM,MAAM,+BAA+B,GAAG;IAC7C,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,IAAI,CAAA;IACrB,QAAQ,EAAE,OAAO,CAAA;CACjB,CAAA;AA6FD,eAAO,MAAM,mBAAmB,gBAzDnB,eAAe,KACzB,OAAO,CAAC,+BAA+B,CAAC,+EAwD4B,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/getPermissionStatus.js

@@ -0,0 +1,85 @@
+import { spendPermissionManagerAbi, spendPermissionManagerAddress, } from '../../../../sign/app-sdk/utils/constants.js';
+import { getClient } from '../../../../store/chain-clients/utils.js';
+import { readContract } from 'viem/actions';
+import { timestampInSecondsToDate, toSpendPermissionArgs } from '../utils.js';
+import { withTelemetry } from '../withTelemetry.js';
+/**
+ * Gets the current status of a spend permission.
+ *
+ * This helper method queries the blockchain to retrieve real-time information
+ * about a spend permission, including how much can still be spent in the current
+ * period, when the next period starts, and whether the permission is still active.
+ *
+ * The function automatically uses the appropriate blockchain client based on the
+ * permission's chain ID and calls multiple view functions on the SpendPermissionManager
+ * contract to gather comprehensive status information.
+ *
+ * When the spend permission does not have a chainId, the function will throw an error.
+ *
+ * @param permission - The spend permission object to check status for.
+ *
+ * @returns A promise that resolves to an object containing permission status details.
+ *
+ * @example
+ * ```typescript
+ * import { getPermissionStatus } from '@startale/app-sdk/spend-permission';
+ *
+ * // Check the status of a permission (no client needed)
+ * const status = await getPermissionStatus(permission);
+ *
+ * console.log(`Remaining spend: ${status.remainingSpend} wei`);
+ * console.log(`Next period starts: ${new Date(parseInt(status.nextPeriodStart) * 1000)}`);
+ * console.log(`Is active: ${status.isActive}`);
+ *
+ * if (status.isActive && status.remainingSpend > BigInt(0)) {
+ *   console.log('Permission can be used for spending');
+ * }
+ * ```
+ */
+const getPermissionStatusFn = async (permission) => {
+    const { chainId } = permission;
+    if (!chainId) {
+        throw new Error('chainId is missing in the spend permission');
+    }
+    const client = getClient(chainId);
+    if (!client) {
+        throw new Error(`No client available for chain ID ${chainId}. Make sure the SDK is in connected state.`);
+    }
+    const spendPermissionArgs = toSpendPermissionArgs(permission);
+    const [currentPeriod, isRevoked, isValid] = await Promise.all([
+        readContract(client, {
+            address: spendPermissionManagerAddress,
+            abi: spendPermissionManagerAbi,
+            functionName: 'getCurrentPeriod',
+            args: [spendPermissionArgs],
+        }),
+        readContract(client, {
+            address: spendPermissionManagerAddress,
+            abi: spendPermissionManagerAbi,
+            functionName: 'isRevoked',
+            args: [spendPermissionArgs],
+        }),
+        readContract(client, {
+            address: spendPermissionManagerAddress,
+            abi: spendPermissionManagerAbi,
+            functionName: 'isValid',
+            args: [spendPermissionArgs],
+        }),
+    ]);
+    // Calculate remaining spend in current period
+    const allowance = BigInt(permission.permission.allowance);
+    const spent = currentPeriod.spend;
+    const remainingSpend = allowance > spent ? allowance - spent : BigInt(0);
+    // Calculate next period start
+    // Next period starts immediately after current period ends
+    const nextPeriodStart = (Number(currentPeriod.end) + 1).toString();
+    // Permission is active if it's not revoked and is still valid
+    const isActive = !isRevoked && isValid;
+    return {
+        remainingSpend,
+        nextPeriodStart: timestampInSecondsToDate(Number(nextPeriodStart)),
+        isActive,
+    };
+};
+export const getPermissionStatus = withTelemetry(getPermissionStatusFn);
+//# sourceMappingURL=getPermissionStatus.js.map

package/dist/interface/public-utilities/spend-permission/methods/getPermissionStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPermissionStatus.js","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/getPermissionStatus.ts"],"names":[],"mappings":"AACA,OAAO,EACN,yBAAyB,EACzB,6BAA6B,GAC7B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAQnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,qBAAqB,GAAG,KAAK,EAClC,UAA2B,EACgB,EAAE;IAC7C,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAA;IAE9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,oCAAoC,OAAO,4CAA4C,CACvF,CAAA;IACF,CAAC;IAED,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAA;IAE7D,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7D,YAAY,CAAC,MAAM,EAAE;YACpB,OAAO,EAAE,6BAA6B;YACtC,GAAG,EAAE,yBAAyB;YAC9B,YAAY,EAAE,kBAAkB;YAChC,IAAI,EAAE,CAAC,mBAAmB,CAAC;SAC3B,CAA2D;QAC5D,YAAY,CAAC,MAAM,EAAE;YACpB,OAAO,EAAE,6BAA6B;YACtC,GAAG,EAAE,yBAAyB;YAC9B,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,mBAAmB,CAAC;SAC3B,CAAqB;QACtB,YAAY,CAAC,MAAM,EAAE;YACpB,OAAO,EAAE,6BAA6B;YACtC,GAAG,EAAE,yBAAyB;YAC9B,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,mBAAmB,CAAC;SAC3B,CAAqB;KACtB,CAAC,CAAA;IAEF,8CAA8C;IAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IACzD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAA;IACjC,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAExE,8BAA8B;IAC9B,2DAA2D;IAC3D,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IAElE,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,CAAC,SAAS,IAAI,OAAO,CAAA;IAEtC,OAAO;QACN,cAAc;QACd,eAAe,EAAE,wBAAwB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAClE,QAAQ;KACR,CAAA;AACF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/prepareRevokeCallData.d.ts

@@ -0,0 +1,10 @@
+import { SpendPermission } from '../../../../core/rpc/coinbase_fetchSpendPermissions.js';
+import { Address, Hex } from 'viem';
+type RevokeSpendPermissionResponse = {
+    to: Address;
+    data: Hex;
+    value: '0x0';
+};
+export declare const prepareRevokeCallData: ((permission: SpendPermission) => Promise<RevokeSpendPermissionResponse>) | ((permission: SpendPermission) => Promise<RevokeSpendPermissionResponse>);
+export {};
+//# sourceMappingURL=prepareRevokeCallData.d.ts.map

package/dist/interface/public-utilities/spend-permission/methods/prepareRevokeCallData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareRevokeCallData.d.ts","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/prepareRevokeCallData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAK7E,OAAO,EAAE,OAAO,EAAE,GAAG,EAAsB,MAAM,MAAM,CAAA;AAIvD,KAAK,6BAA6B,GAAG;IACpC,EAAE,EAAE,OAAO,CAAA;IACX,IAAI,EAAE,GAAG,CAAA;IACT,KAAK,EAAE,KAAK,CAAA;CACZ,CAAA;AAoDD,eAAO,MAAM,qBAAqB,gBAlBrB,eAAe,KACzB,OAAO,CAAC,6BAA6B,CAAC,6EAiBkC,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/prepareRevokeCallData.js

@@ -0,0 +1,51 @@
+import { spendPermissionManagerAbi, spendPermissionManagerAddress, } from '../../../../sign/app-sdk/utils/constants.js';
+import { encodeFunctionData } from 'viem';
+import { toSpendPermissionArgs } from '../utils.js';
+import { withTelemetry } from '../withTelemetry.js';
+/**
+ * Prepares call data for revoking a spend permission without user interaction.
+ *
+ * This helper method generates the encoded transaction data needed to revoke a spend
+ * permission silently, without opening a popup or requiring user approval. This is
+ * useful for automated or programmatic revocations where user interaction is not desired.
+ *
+ * The returned call data can be used with other transaction methods or batch operations.
+ *
+ * If you need simpler revoke flow, use `requestRevoke` instead, which opens a popup to ask
+ * the user to revoke the permission.
+ *
+ * @param permission - The spend permission object containing the permission details to revoke.
+ *
+ * @returns A promise that resolves to an object containing the contract address and encoded call data.
+ *
+ * @example
+ * ```typescript
+ * import { prepareRevokeCallData } from '@startale/app-sdk/spend-permission';
+ *
+ * // Prepare revoke call data for silent execution
+ * const { to, data } = await prepareRevokeCallData({ permission: myPermission });
+ *
+ * // Use the call data in a batch transaction or other context
+ * const call = {
+ *   to,
+ *   data,
+ *   value: '0x0'
+ * };
+ * ```
+ */
+const prepareRevokeCallDataFn = async (permission) => {
+    const spendPermissionArgs = toSpendPermissionArgs(permission);
+    const data = encodeFunctionData({
+        abi: spendPermissionManagerAbi,
+        functionName: 'revokeAsSpender',
+        args: [spendPermissionArgs],
+    });
+    const response = {
+        to: spendPermissionManagerAddress,
+        data,
+        value: '0x0', // explicitly set to 0x0
+    };
+    return response;
+};
+export const prepareRevokeCallData = withTelemetry(prepareRevokeCallDataFn);
+//# sourceMappingURL=prepareRevokeCallData.js.map

package/dist/interface/public-utilities/spend-permission/methods/prepareRevokeCallData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareRevokeCallData.js","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/prepareRevokeCallData.ts"],"names":[],"mappings":"AACA,OAAO,EACN,yBAAyB,EACzB,6BAA6B,GAC7B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAgB,kBAAkB,EAAE,MAAM,MAAM,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAQnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,uBAAuB,GAAG,KAAK,EACpC,UAA2B,EACc,EAAE;IAC3C,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC/B,GAAG,EAAE,yBAAyB;QAC9B,YAAY,EAAE,iBAAiB;QAC/B,IAAI,EAAE,CAAC,mBAAmB,CAAC;KAC3B,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAkC;QAC/C,EAAE,EAAE,6BAA6B;QACjC,IAAI;QACJ,KAAK,EAAE,KAAK,EAAE,wBAAwB;KACtC,CAAA;IAED,OAAO,QAAQ,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/prepareSpendCallData.d.ts

@@ -0,0 +1,11 @@
+import { SpendPermission } from '../../../../core/rpc/coinbase_fetchSpendPermissions.js';
+import { Address, Hex } from 'viem';
+type Call = {
+    to: Address;
+    data: Hex;
+    value: '0x0';
+};
+export type PrepareSpendCallDataResponseType = Call[];
+export declare const prepareSpendCallData: ((permission: SpendPermission, amount: bigint | "max-remaining-allowance") => Promise<PrepareSpendCallDataResponseType>) | ((permission: SpendPermission, amount: bigint | "max-remaining-allowance") => Promise<PrepareSpendCallDataResponseType>);
+export {};
+//# sourceMappingURL=prepareSpendCallData.d.ts.map

package/dist/interface/public-utilities/spend-permission/methods/prepareSpendCallData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareSpendCallData.d.ts","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/prepareSpendCallData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAK7E,OAAO,EAAE,OAAO,EAAE,GAAG,EAAsB,MAAM,MAAM,CAAA;AAMvD,KAAK,IAAI,GAAG;IACX,EAAE,EAAE,OAAO,CAAA;IACX,IAAI,EAAE,GAAG,CAAA;IACT,KAAK,EAAE,KAAK,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG,IAAI,EAAE,CAAA;AA+GrD,eAAO,MAAM,oBAAoB,gBA9CpB,eAAe,UACnB,MAAM,GAAG,yBAAyB,KACxC,OAAO,CAAC,gCAAgC,CAAC,4HA4C6B,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/prepareSpendCallData.js

@@ -0,0 +1,104 @@
+import { spendPermissionManagerAbi, spendPermissionManagerAddress, } from '../../../../sign/app-sdk/utils/constants.js';
+import { encodeFunctionData } from 'viem';
+import { toSpendPermissionArgs } from '../utils.js';
+import { withTelemetry } from '../withTelemetry.js';
+import { getPermissionStatus } from './getPermissionStatus.js';
+/**
+ * Prepares call data for approving and spending a spend permission.
+ *
+ * This helper method constructs the call data for `approveWithSignature`
+ * and `spend` functions. The approve call is only included when the permission
+ * is not yet active. If the permission is already approved, only the spend call is returned.
+ *
+ * When 'max-remaining-allowance' is provided as the amount, the function automatically uses all remaining
+ * spend permission allowance.
+ *
+ * The resulting call data must be sent using the spender account, not the
+ * account holder. The spender is responsible for executing both the approval
+ * and spend operations.
+ *
+ * @param permission - The spend permission object containing the permission details and signature.
+ * @param amount - The amount to spend in wei. If 'max-remaining-allowance' is provided, the full remaining allowance will be spent.
+ *
+ * @returns A promise that resolves to an array containing all the necessary calls.
+ *
+ * @example
+ * ```typescript
+ * import { prepareSpendCallData } from '@startale/app-sdk/spend-permission';
+ *
+ * // Prepare calls to approve and spend a specific amount from a permission
+ * const spendCalls = await prepareSpendCallData(
+ *   permission, // from requestSpendPermission or fetchPermissions
+ *   50n * 10n ** 6n // spend 50 USDC (6 decimals)
+ * );
+ *
+ * // To spend all remaining allowance, use 'max-remaining-allowance'
+ * const callsFullAmount = await prepareSpendCallData(
+ *   permission,
+ *   'max-remaining-allowance'
+ * );
+ *
+ * // Send the calls using your app's spender account
+ * // this is an example of how to send the calls using the wallet_sendCalls method
+ * await provider.request({
+ *   method: 'wallet_sendCalls',
+ *   params: [{
+ *     version: '2.0.0',
+ *     atomicRequired: true,
+ *     from: permission.permission.spender, // Must be the spender!
+ *     chainId: `0x${permission.chainId?.toString(16)}`,
+ *     calls: spendCalls,
+ *   }],
+ * });
+ *
+ * // Or send the calls using eth_sendTransaction to submit both calls in exact order
+ * const promises = spendCalls.map((call) => provider.request({
+ *   method: 'eth_sendTransaction',
+ *   params: [
+ *     {
+ *       ...call,
+ *       from: permission.permission.spender, // Must be the spender!
+ *     }
+ *   ]
+ * }))
+ *
+ * await Promise.all(promises);
+ * ```
+ */
+const prepareSpendCallDataFn = async (permission, amount) => {
+    const { remainingSpend, isActive } = await getPermissionStatus(permission);
+    const spendAmount = amount === 'max-remaining-allowance' ? remainingSpend : amount;
+    if (spendAmount === BigInt(0)) {
+        throw new Error('Spend amount cannot be 0');
+    }
+    if (spendAmount > remainingSpend) {
+        throw new Error('Remaining spend amount is insufficient');
+    }
+    let approveCall = null;
+    const spendPermissionArgs = toSpendPermissionArgs(permission);
+    if (!isActive) {
+        const approveData = encodeFunctionData({
+            abi: spendPermissionManagerAbi,
+            functionName: 'approveWithSignature',
+            args: [spendPermissionArgs, permission.signature],
+        });
+        approveCall = {
+            to: spendPermissionManagerAddress,
+            data: approveData,
+            value: '0x0', // explicitly set to 0x0
+        };
+    }
+    const spendData = encodeFunctionData({
+        abi: spendPermissionManagerAbi,
+        functionName: 'spend',
+        args: [spendPermissionArgs, spendAmount],
+    });
+    const spendCall = {
+        to: spendPermissionManagerAddress,
+        data: spendData,
+        value: '0x0', // explicitly set to 0x0
+    };
+    return [approveCall, spendCall].filter((item) => item !== null);
+};
+export const prepareSpendCallData = withTelemetry(prepareSpendCallDataFn);
+//# sourceMappingURL=prepareSpendCallData.js.map

package/dist/interface/public-utilities/spend-permission/methods/prepareSpendCallData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareSpendCallData.js","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/prepareSpendCallData.ts"],"names":[],"mappings":"AACA,OAAO,EACN,yBAAyB,EACzB,6BAA6B,GAC7B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAgB,kBAAkB,EAAE,MAAM,MAAM,CAAA;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAU9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,sBAAsB,GAAG,KAAK,EACnC,UAA2B,EAC3B,MAA0C,EACE,EAAE;IAC9C,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAA;IAC1E,MAAM,WAAW,GAChB,MAAM,KAAK,yBAAyB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAA;IAE/D,IAAI,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC5C,CAAC;IAED,IAAI,WAAW,GAAG,cAAc,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC1D,CAAC;IAED,IAAI,WAAW,GAAgB,IAAI,CAAA;IAEnC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAA;IAE7D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,kBAAkB,CAAC;YACtC,GAAG,EAAE,yBAAyB;YAC9B,YAAY,EAAE,sBAAsB;YACpC,IAAI,EAAE,CAAC,mBAAmB,EAAE,UAAU,CAAC,SAA0B,CAAC;SAClE,CAAC,CAAA;QACF,WAAW,GAAG;YACb,EAAE,EAAE,6BAA6B;YACjC,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,KAAK,EAAE,wBAAwB;SACtC,CAAA;IACF,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACpC,GAAG,EAAE,yBAAyB;QAC9B,YAAY,EAAE,OAAO;QACrB,IAAI,EAAE,CAAC,mBAAmB,EAAE,WAAW,CAAC;KACxC,CAAC,CAAA;IACF,MAAM,SAAS,GAAS;QACvB,EAAE,EAAE,6BAA6B;QACjC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,KAAK,EAAE,wBAAwB;KACtC,CAAA;IAED,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAChE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC,sBAAsB,CAAC,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/requestRevoke.d.ts

@@ -0,0 +1,11 @@
+import { ProviderInterface } from '../../../../core/provider/interface.js';
+import { SpendPermission } from '../../../../core/rpc/coinbase_fetchSpendPermissions.js';
+import { Hex } from 'viem';
+export declare const requestRevoke: (({ provider, permission, }: {
+    provider: ProviderInterface;
+    permission: SpendPermission;
+}) => Promise<Hex>) | ((args_0: {
+    provider: ProviderInterface;
+    permission: SpendPermission;
+}) => Promise<`0x${string}`>);
+//# sourceMappingURL=requestRevoke.d.ts.map

package/dist/interface/public-utilities/spend-permission/methods/requestRevoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestRevoke.d.ts","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/requestRevoke.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAK7E,OAAO,EAAE,GAAG,EAAmC,MAAM,MAAM,CAAA;AA0E3D,eAAO,MAAM,aAAa,+BAtCvB;IACF,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,UAAU,EAAE,eAAe,CAAA;CAC3B,KAAG,OAAO,CAAC,GAAG,CAAC;cAFL,iBAAiB;gBACf,eAAe;6BAoC+B,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/requestRevoke.js

@@ -0,0 +1,64 @@
+import { spendPermissionManagerAbi, spendPermissionManagerAddress, } from '../../../../sign/app-sdk/utils/constants.js';
+import { encodeFunctionData, numberToHex } from 'viem';
+import { toSpendPermissionArgs } from '../utils.js';
+import { withTelemetry } from '../withTelemetry.js';
+/**
+ * Requests user approval to revoke a spend permission.
+ *
+ * This helper method opens a popup to ask the user to revoke a spend permission.
+ * It requires no additional setup from the app side and handles the entire revoke
+ * flow by calling the smart contract's revoke function through wallet_sendCalls.
+ *
+ * If you're looking for a silent revoke that doesn't require user interaction,
+ * use `prepareRevokeCallData` instead, which requires extra configuration.
+ *
+ * @param params - The parameters for the requestRevoke method.
+ * @param params.permission - The spend permission object to revoke. Must include a valid chainId.
+ * @param params.provider - The provider interface used to make the wallet_sendCalls request.
+ *
+ * @returns A promise that resolves to the transaction hash as a hex string.
+ *
+ * @example
+ * ```typescript
+ * import { requestRevoke } from '@startale/app-sdk/spend-permission';
+ *
+ * // Revoke a spend permission with user approval
+ * try {
+ *   const hash = await requestRevoke({ permission, provider });
+ *   console.log(`Permission revoked in transaction: ${hash}`);
+ * } catch (error) {
+ *   console.error('Failed to revoke permission:', error);
+ * }
+ * ```
+ */
+const requestRevokeFn = async ({ provider, permission, }) => {
+    const { chainId } = permission;
+    if (!chainId) {
+        throw new Error('chainId is required in the spend permission');
+    }
+    const spendPermissionArgs = toSpendPermissionArgs(permission);
+    const data = encodeFunctionData({
+        abi: spendPermissionManagerAbi,
+        functionName: 'revoke',
+        args: [spendPermissionArgs],
+    });
+    const call = {
+        to: spendPermissionManagerAddress,
+        data,
+    };
+    const result = (await provider.request({
+        method: 'wallet_sendCalls',
+        params: [
+            {
+                version: '2.0.0',
+                from: permission.permission.account,
+                chainId: numberToHex(chainId),
+                atomicRequired: true,
+                calls: [call],
+            },
+        ],
+    }));
+    return result;
+};
+export const requestRevoke = withTelemetry(requestRevokeFn);
+//# sourceMappingURL=requestRevoke.js.map

package/dist/interface/public-utilities/spend-permission/methods/requestRevoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestRevoke.js","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/requestRevoke.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,yBAAyB,EACzB,6BAA6B,GAC7B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAO,kBAAkB,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,eAAe,GAAG,KAAK,EAAE,EAC9B,QAAQ,EACR,UAAU,GAIV,EAAgB,EAAE;IAClB,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAA;IAE9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC/B,GAAG,EAAE,yBAAyB;QAC9B,YAAY,EAAE,QAAQ;QACtB,IAAI,EAAE,CAAC,mBAAmB,CAAC;KAC3B,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG;QACZ,EAAE,EAAE,6BAA6B;QACjC,IAAI;KACJ,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC;QACtC,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE;YACP;gBACC,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO;gBACnC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;gBAC7B,cAAc,EAAE,IAAI;gBACpB,KAAK,EAAE,CAAC,IAAI,CAAC;aACb;SACD;KACD,CAAC,CAAQ,CAAA;IAEV,OAAO,MAAM,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,eAAe,CAAC,CAAA"}

package/dist/interface/public-utilities/spend-permission/methods/requestSpendPermission.d.ts

@@ -0,0 +1,20 @@
+import { SpendPermission } from '../../../../core/rpc/coinbase_fetchSpendPermissions.js';
+import { ProviderInterface } from '../../../../core/provider/interface.js';
+export type RequestSpendPermissionType = {
+    account: string;
+    spender: string;
+    token: string;
+    chainId: number;
+    allowance: bigint;
+    periodInDays: number;
+    start?: Date;
+    end?: Date;
+    salt?: string;
+    extraData?: string;
+};
+export declare const requestSpendPermission: ((request: RequestSpendPermissionType & {
+    provider: ProviderInterface;
+}) => Promise<SpendPermission>) | ((request: RequestSpendPermissionType & {
+    provider: ProviderInterface;
+}) => Promise<SpendPermission>);
+//# sourceMappingURL=requestSpendPermission.d.ts.map

package/dist/interface/public-utilities/spend-permission/methods/requestSpendPermission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestSpendPermission.d.ts","sourceRoot":"","sources":["../../../../../src/interface/public-utilities/spend-permission/methods/requestSpendPermission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAQ/D,MAAM,MAAM,0BAA0B,GAAG;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAuED,eAAO,MAAM,sBAAsB,aAzBzB,0BAA0B,GAAG;IAAE,QAAQ,EAAE,iBAAiB,CAAA;CAAE,KACnE,OAAO,CAAC,eAAe,CAAC;cADwB,iBAAiB;+BAyBS,CAAA"}