@medialane/sdk 0.166.0 → 0.168.0

package/dist/starknet/index.d.cts

@@ -1,7 +1,7 @@
-import { bC as ResolvedConfig, aZ as CreatePopCollectionParams, bJ as TxResult, aK as ClaimConditions, aV as CreateDropParams, b2 as CreateTicketParams, bn as MintTicketsParams, aX as CreateMembershipParams, bm as MintMembershipsParams, b0 as CreateSponsorshipOfferParams, bz as ProposeSponsorshipParams, k as ApiClient, bk as MedialaneConfig, bl as MedialaneErrorCode, bs as OrderDetails, R as ResolvedFeeConfig, I as ApiFundingIntent, H as ApiFundingInstructions, L as ApiFundingSubmit, N as ApiIntentCreated, bP as SealedOwner, bQ as ReceiptProviderLike, bR as WalletExecutor, bS as ExecutedTransaction, bT as PasskeyOwner, bU as CreatedOwner } from '../errors-GcSzVvZL.cjs';
-export { bV as InvalidRecoveryKeyError, bW as OwnerSigner, bv as PasskeyCancelledError, bX as PasskeyConfig, bw as PasskeyUnsupportedError, bx as PasskeyUnsupportedReason, bY as RecoveryKey, bL as UserFacingError, bZ as createPasskeyOwner, b_ as encodeRecoveryKey, b$ as parseRecoveryKey } from '../errors-GcSzVvZL.cjs';
+import { bS as ResolvedConfig, b5 as CreatePopCollectionParams, bZ as TxResult, aK as ClaimConditions, aZ as CreateDropParams, bc as CreateTicketParams, bC as MintTicketsParams, b1 as CreateMembershipParams, bB as MintMembershipsParams, b9 as CreateSponsorshipOfferParams, bP as ProposeSponsorshipParams, k as ApiClient, bz as MedialaneConfig, bA as MedialaneErrorCode, bH as OrderDetails, R as ResolvedFeeConfig, I as ApiFundingIntent, H as ApiFundingInstructions, L as ApiFundingSubmit, N as ApiIntentCreated, c4 as SealedOwner, c5 as ReceiptProviderLike, c6 as WalletExecutor, c7 as ExecutedTransaction, c8 as PasskeyOwner, bh as CreateWalletManageIntentParams, c9 as CreatedOwner } from '../errors-CwqwX-vA.cjs';
+export { ca as InvalidRecoveryKeyError, cb as OwnerSigner, bK as PasskeyCancelledError, cc as PasskeyConfig, bL as PasskeyUnsupportedError, bM as PasskeyUnsupportedReason, cd as RecoveryKey, b$ as UserFacingError, ce as createPasskeyOwner, cf as encodeRecoveryKey, cg as parseRecoveryKey } from '../errors-CwqwX-vA.cjs';
 import { AccountInterface, ProviderInterface, Call, TypedData, constants, BigNumberish, DeployAccountContractPayload, Account } from 'starknet';
-import { V as VenueAdapter, O as OrderRef, A as AdapterTxResult, R as RegisterOrderParams, j as VenueSigner } from '../types-PPshMWr7.cjs';
+import { V as VenueAdapter, O as OrderRef, A as AdapterTxResult, R as RegisterOrderParams, j as VenueSigner } from '../types-C-y68Ut2.cjs';
 import 'zod';
 
 declare class PopService {
@@ -501,8 +501,14 @@ type FundingResult = {
     intentId: string;
     reason: string;
 };
-interface FundWithTransferOptions {
+type FundWithTransferOptions = ({
+    amount: string;
+    amountUsdc?: never;
+} | {
     amountUsdc: string;
+    amount?: never;
+}) & FundWithTransferRest;
+interface FundWithTransferRest {
     onStep?: (step: FundingStep) => void;
     pollMs?: number;
     maxPolls?: number;
@@ -8255,6 +8261,7 @@ interface TypedDataSigner {
 interface SponsoredExecuteConfig {
     proxyUrl: string;
     fetchImpl?: typeof fetch;
+    headers?: Record<string, string>;
 }
 type SponsoredExecuteResult = {
     status: "sponsored";
@@ -8267,7 +8274,7 @@ declare class SponsoredCallRejectedError extends Error {
 }
 type SponsorshipFailureCode = "sponsor_unavailable" | "credits_exhausted" | "account_not_deployed" | "not_executable" | "invalid_request" | "not_authorized" | "rate_limited" | "may_have_broadcast";
 declare function allowsFallbackFunding(code: string | undefined, status: number, stage: "build" | "execute"): boolean;
-declare function executeSponsored(config: SponsoredExecuteConfig, signer: TypedDataSigner, calls: Call[]): Promise<SponsoredExecuteResult>;
+declare function executeSponsored(config: SponsoredExecuteConfig, signer: TypedDataSigner, calls: Call[], intentIds?: string[]): Promise<SponsoredExecuteResult>;
 
 declare function encodeByteArray(str: string): string[];
 
@@ -8472,6 +8479,10 @@ interface MediaWalletConfig {
     backendUrl?: string;
     deployProxyUrl?: string;
     fetchImpl?: typeof fetch;
+    walletIntents?: (params: CreateWalletManageIntentParams) => Promise<{
+        id: string;
+        calls: Call[];
+    }>;
 }
 interface MediaWallet {
     store: OwnerStore;
@@ -8480,11 +8491,13 @@ interface MediaWallet {
     signerFor(sealed: SealedOwner): {
         address: string;
         signTypedData(data: TypedData): Promise<string[]>;
-        execute(calls: Call[]): Promise<{
+        execute(calls: Call[], opts?: {
+            intentIds?: string[];
+        }): Promise<{
             txHash: string;
         }>;
     };
-    run(sealed: SealedOwner, calls: Call[], userAddress?: string): Promise<ExecutedTransaction>;
+    run(sealed: SealedOwner, calls: Call[], userAddress?: string, intentIds?: string[]): Promise<ExecutedTransaction>;
     getGuardians(address: string): Promise<GuardianInfo[]>;
     getEscape(address: string): Promise<EscapeInfo>;
     getEscapeSecurityPeriod(address: string): Promise<number>;

package/dist/starknet/index.d.ts

@@ -1,7 +1,7 @@
-import { bC as ResolvedConfig, aZ as CreatePopCollectionParams, bJ as TxResult, aK as ClaimConditions, aV as CreateDropParams, b2 as CreateTicketParams, bn as MintTicketsParams, aX as CreateMembershipParams, bm as MintMembershipsParams, b0 as CreateSponsorshipOfferParams, bz as ProposeSponsorshipParams, k as ApiClient, bk as MedialaneConfig, bl as MedialaneErrorCode, bs as OrderDetails, R as ResolvedFeeConfig, I as ApiFundingIntent, H as ApiFundingInstructions, L as ApiFundingSubmit, N as ApiIntentCreated, bP as SealedOwner, bQ as ReceiptProviderLike, bR as WalletExecutor, bS as ExecutedTransaction, bT as PasskeyOwner, bU as CreatedOwner } from '../errors-DRiTDrwm.js';
-export { bV as InvalidRecoveryKeyError, bW as OwnerSigner, bv as PasskeyCancelledError, bX as PasskeyConfig, bw as PasskeyUnsupportedError, bx as PasskeyUnsupportedReason, bY as RecoveryKey, bL as UserFacingError, bZ as createPasskeyOwner, b_ as encodeRecoveryKey, b$ as parseRecoveryKey } from '../errors-DRiTDrwm.js';
+import { bS as ResolvedConfig, b5 as CreatePopCollectionParams, bZ as TxResult, aK as ClaimConditions, aZ as CreateDropParams, bc as CreateTicketParams, bC as MintTicketsParams, b1 as CreateMembershipParams, bB as MintMembershipsParams, b9 as CreateSponsorshipOfferParams, bP as ProposeSponsorshipParams, k as ApiClient, bz as MedialaneConfig, bA as MedialaneErrorCode, bH as OrderDetails, R as ResolvedFeeConfig, I as ApiFundingIntent, H as ApiFundingInstructions, L as ApiFundingSubmit, N as ApiIntentCreated, c4 as SealedOwner, c5 as ReceiptProviderLike, c6 as WalletExecutor, c7 as ExecutedTransaction, c8 as PasskeyOwner, bh as CreateWalletManageIntentParams, c9 as CreatedOwner } from '../errors-CWbsAodQ.js';
+export { ca as InvalidRecoveryKeyError, cb as OwnerSigner, bK as PasskeyCancelledError, cc as PasskeyConfig, bL as PasskeyUnsupportedError, bM as PasskeyUnsupportedReason, cd as RecoveryKey, b$ as UserFacingError, ce as createPasskeyOwner, cf as encodeRecoveryKey, cg as parseRecoveryKey } from '../errors-CWbsAodQ.js';
 import { AccountInterface, ProviderInterface, Call, TypedData, constants, BigNumberish, DeployAccountContractPayload, Account } from 'starknet';
-import { V as VenueAdapter, O as OrderRef, A as AdapterTxResult, R as RegisterOrderParams, j as VenueSigner } from '../types-PPshMWr7.js';
+import { V as VenueAdapter, O as OrderRef, A as AdapterTxResult, R as RegisterOrderParams, j as VenueSigner } from '../types-C-y68Ut2.js';
 import 'zod';
 
 declare class PopService {
@@ -501,8 +501,14 @@ type FundingResult = {
     intentId: string;
     reason: string;
 };
-interface FundWithTransferOptions {
+type FundWithTransferOptions = ({
+    amount: string;
+    amountUsdc?: never;
+} | {
     amountUsdc: string;
+    amount?: never;
+}) & FundWithTransferRest;
+interface FundWithTransferRest {
     onStep?: (step: FundingStep) => void;
     pollMs?: number;
     maxPolls?: number;
@@ -8255,6 +8261,7 @@ interface TypedDataSigner {
 interface SponsoredExecuteConfig {
     proxyUrl: string;
     fetchImpl?: typeof fetch;
+    headers?: Record<string, string>;
 }
 type SponsoredExecuteResult = {
     status: "sponsored";
@@ -8267,7 +8274,7 @@ declare class SponsoredCallRejectedError extends Error {
 }
 type SponsorshipFailureCode = "sponsor_unavailable" | "credits_exhausted" | "account_not_deployed" | "not_executable" | "invalid_request" | "not_authorized" | "rate_limited" | "may_have_broadcast";
 declare function allowsFallbackFunding(code: string | undefined, status: number, stage: "build" | "execute"): boolean;
-declare function executeSponsored(config: SponsoredExecuteConfig, signer: TypedDataSigner, calls: Call[]): Promise<SponsoredExecuteResult>;
+declare function executeSponsored(config: SponsoredExecuteConfig, signer: TypedDataSigner, calls: Call[], intentIds?: string[]): Promise<SponsoredExecuteResult>;
 
 declare function encodeByteArray(str: string): string[];
 
@@ -8472,6 +8479,10 @@ interface MediaWalletConfig {
     backendUrl?: string;
     deployProxyUrl?: string;
     fetchImpl?: typeof fetch;
+    walletIntents?: (params: CreateWalletManageIntentParams) => Promise<{
+        id: string;
+        calls: Call[];
+    }>;
 }
 interface MediaWallet {
     store: OwnerStore;
@@ -8480,11 +8491,13 @@ interface MediaWallet {
     signerFor(sealed: SealedOwner): {
         address: string;
         signTypedData(data: TypedData): Promise<string[]>;
-        execute(calls: Call[]): Promise<{
+        execute(calls: Call[], opts?: {
+            intentIds?: string[];
+        }): Promise<{
             txHash: string;
         }>;
     };
-    run(sealed: SealedOwner, calls: Call[], userAddress?: string): Promise<ExecutedTransaction>;
+    run(sealed: SealedOwner, calls: Call[], userAddress?: string, intentIds?: string[]): Promise<ExecutedTransaction>;
     getGuardians(address: string): Promise<GuardianInfo[]>;
     getEscape(address: string): Promise<EscapeInfo>;
     getEscapeSecurityPeriod(address: string): Promise<number>;

package/dist/starknet/index.js

@@ -1,5 +1,5 @@
-import { normalizeAddress, collectionHref, resolveConfig, ApiClient, UserFacingError, getService, STARKNET_MEDIAWALLET_CLASS_HASH, computeAccountAddress, ownerConstructorCalldata, getTokenBySymbol, signWithPrivateKey, stringifyBigInts, SUPPORTED_TOKENS, starkKeyPairFromPrivateKey, createFailoverFetch } from '../chunk-USFXQO4T.js';
-export { InvalidStarkPrivateKeyError, PasskeyCancelledError, PasskeyUnsupportedError, UserFacingError, computeAccountAddress, createPasskeyOwner, deriveAesKey, generateStarkKeyPair, ownerConstructorCalldata, sealPrivateKey, signWithPrivateKey, starkKeyPairFromPrivateKey, unsealPrivateKey } from '../chunk-USFXQO4T.js';
+import { normalizeAddress, collectionHref, resolveConfig, ApiClient, UserFacingError, getService, STARKNET_MEDIAWALLET_CLASS_HASH, computeAccountAddress, ownerConstructorCalldata, getTokenBySymbol, signWithPrivateKey, stringifyBigInts, SUPPORTED_TOKENS, starkKeyPairFromPrivateKey, createFailoverFetch } from '../chunk-3QGECZBS.js';
+export { InvalidStarkPrivateKeyError, PasskeyCancelledError, PasskeyUnsupportedError, UserFacingError, computeAccountAddress, createPasskeyOwner, deriveAesKey, generateStarkKeyPair, ownerConstructorCalldata, sealPrivateKey, signWithPrivateKey, starkKeyPairFromPrivateKey, unsealPrivateKey } from '../chunk-3QGECZBS.js';
 import { getStarknetCoordinates, getCoordinates } from '../chunk-PBJLHXDB.js';
 import { hash, cairo, uint256, RpcProvider, CairoOption, CairoOptionVariant, num, ec, validateAndParseAddress, Account, typedData, stark, CallData, byteArray, Contract, TypedDataRevision, constants, shortString } from 'starknet';
 import { extract, expand } from '@noble/hashes/hkdf.js';
@@ -11238,7 +11238,8 @@ async function fundWithChainTransfer(api, wallet, options) {
   const pollMs = options.pollMs ?? 3e3;
   const maxPolls = options.maxPolls ?? 20;
   step("creating");
-  const { data: intent } = await api.createFunding({ method: "chain-transfer", params: { amountUsdc: options.amountUsdc } });
+  const params = options.amount !== void 0 ? { amount: options.amount } : { amountUsdc: options.amountUsdc };
+  const { data: intent } = await api.createFunding({ method: "chain-transfer", params });
   let txHash;
   let transferStarted = false;
   try {
@@ -11316,7 +11317,7 @@ async function executeIntent(provider, signer, client, intent, opts = {}) {
   } else {
     calls = intent.calls;
   }
-  const { txHash } = await signer.execute(calls);
+  const { txHash } = await signer.execute(calls, { intentIds: [intent.id] });
   const receipt = await assertTransactionSucceeded(provider, txHash);
   await Promise.all([
     syncTransactionBestEffort(client, txHash),
@@ -11329,7 +11330,7 @@ async function executeIntents(provider, signer, client, intents, opts = {}) {
     throw new Error("Expected prebuilt intents (requiresSignature=false)");
   }
   const calls = intents.flatMap((i) => i.calls);
-  const { txHash } = await signer.execute(calls);
+  const { txHash } = await signer.execute(calls, { intentIds: intents.map((i) => i.id) });
   const receipt = await assertTransactionSucceeded(provider, txHash);
   await Promise.all([
     syncTransactionBestEffort(client, txHash),
@@ -11391,14 +11392,14 @@ async function failureOf(res, fallback) {
   const body = await res.json().catch(() => null);
   return { reason: body?.error || fallback, code: typeof body?.code === "string" ? body.code : void 0 };
 }
-async function executeSponsored(config, signer, calls) {
+async function executeSponsored(config, signer, calls, intentIds) {
   const doFetch = config.fetchImpl ?? fetch;
   const base = config.proxyUrl.replace(/\/$/, "");
-  const headers = { "Content-Type": "application/json" };
+  const headers = { "Content-Type": "application/json", ...config.headers };
   const buildRes = await doFetch(`${base}/build`, {
     method: "POST",
     headers,
-    body: JSON.stringify({ userAddress: signer.address, calls })
+    body: JSON.stringify(intentIds ? { intentIds } : { userAddress: signer.address, calls })
   });
   if (!buildRes.ok) {
     const { reason, code } = await failureOf(buildRes, "We couldn't prepare this transaction.");
@@ -11410,7 +11411,7 @@ async function executeSponsored(config, signer, calls) {
   const executeRes = await doFetch(`${base}/execute`, {
     method: "POST",
     headers,
-    body: JSON.stringify({ userAddress: signer.address, typedData, signature, calls })
+    body: JSON.stringify(intentIds ? { intentIds, typedData, signature } : { userAddress: signer.address, typedData, signature, calls })
   });
   if (!executeRes.ok) {
     const { reason, code } = await failureOf(executeRes, "We couldn't submit this transaction.");
@@ -11791,14 +11792,15 @@ function sponsoredExecutor(deps) {
   const fallback = deps.fallback ?? selfFundedExecutor(deps);
   return {
     async execute(input) {
-      const { userAddress, privateKeyHex, calls } = input;
+      const { userAddress, privateKeyHex, calls, intentIds } = input;
       const result = await executeSponsored(
         { proxyUrl: deps.proxyUrl, fetchImpl: deps.fetchImpl },
         {
           address: userAddress,
           signTypedData: async (data) => signWithPrivateKey(privateKeyHex, typedData.getMessageHash(data, userAddress))
         },
-        calls
+        calls,
+        intentIds
       );
       if (result.status === "sponsored") return { transactionHash: result.transactionHash };
       const consented = await deps.consent.request({ address: userAddress, calls });
@@ -12012,14 +12014,25 @@ function createMediaWallet(config) {
     unlockCache.set(sealed.address, { promise, timer });
     return promise;
   };
-  const run = async (sealed, calls, userAddress) => {
+  const run = async (sealed, calls, userAddress, intentIds) => {
     const privateKeyHex = await unlockOnce(sealed);
     return config.executor.execute({
       userAddress: userAddress ?? sealed.address,
       privateKeyHex,
-      calls
+      calls,
+      intentIds
     });
   };
+  const walletIntents = config.walletIntents ?? (async (params) => {
+    if (!config.backendUrl) throw new Error("This wallet has no backend url configured");
+    const created = await new ApiClient(config.backendUrl).createWalletManageIntent(params);
+    return created.data;
+  });
+  const manage = async (sealed, params) => {
+    const intent = await walletIntents(params);
+    const { transactionHash } = await run(sealed, intent.calls, params.owner, [intent.id]);
+    return transactionHash;
+  };
   return {
     store: config.store,
     passkey: config.passkey,
@@ -12031,8 +12044,8 @@ function createMediaWallet(config) {
           const privateKeyHex = await unlockOnce(sealed);
           return signWithPrivateKey(privateKeyHex, typedData.getMessageHash(data, sealed.address));
         },
-        execute: async (calls) => {
-          const { transactionHash } = await run(sealed, calls);
+        execute: async (calls, opts) => {
+          const { transactionHash } = await run(sealed, calls, void 0, opts?.intentIds);
           return { txHash: transactionHash };
         }
       };
@@ -12047,38 +12060,12 @@ function createMediaWallet(config) {
       const guid = BigInt(computeOwnerGuid(devicePubkey));
       return owners.some((owner) => BigInt(owner.guid) === guid);
     },
-    async setFirstGuardian(sealed, guardianPubkey) {
-      const { transactionHash } = await run(sealed, [buildSetFirstGuardianCall(sealed.address, guardianPubkey)]);
-      return transactionHash;
-    },
-    async triggerEscapeOwner(guardianSealed, targetAddress, newOwnerPubkey) {
-      const { transactionHash } = await run(
-        guardianSealed,
-        [buildTriggerEscapeOwnerCall(targetAddress, newOwnerPubkey)],
-        normalizeWalletAddress(targetAddress)
-      );
-      return transactionHash;
-    },
-    async completeEscapeOwner(guardianSealed, targetAddress) {
-      const { transactionHash } = await run(
-        guardianSealed,
-        [buildCompleteEscapeOwnerCall(targetAddress)],
-        normalizeWalletAddress(targetAddress)
-      );
-      return transactionHash;
-    },
-    async cancelEscape(sealed) {
-      const { transactionHash } = await run(sealed, [buildCancelEscapeCall(sealed.address)]);
-      return transactionHash;
-    },
-    async addDevice(sealed, devicePubkey) {
-      const { transactionHash } = await run(sealed, [buildAddOwnerCall(sealed.address, devicePubkey)]);
-      return transactionHash;
-    },
-    async removeDevice(sealed, ownerGuid) {
-      const { transactionHash } = await run(sealed, [buildRemoveOwnerByGuidCall(sealed.address, ownerGuid)]);
-      return transactionHash;
-    },
+    setFirstGuardian: (sealed, guardianPubkey) => manage(sealed, { owner: sealed.address, action: "set_first_guardian", pubkey: guardianPubkey }),
+    triggerEscapeOwner: (guardianSealed, targetAddress, newOwnerPubkey) => manage(guardianSealed, { owner: normalizeWalletAddress(targetAddress), action: "trigger_escape", newOwnerPubkey }),
+    completeEscapeOwner: (guardianSealed, targetAddress) => manage(guardianSealed, { owner: normalizeWalletAddress(targetAddress), action: "complete_escape" }),
+    cancelEscape: (sealed) => manage(sealed, { owner: sealed.address, action: "cancel_escape" }),
+    addDevice: (sealed, devicePubkey) => manage(sealed, { owner: sealed.address, action: "add_owner", pubkey: devicePubkey }),
+    removeDevice: (sealed, ownerGuid) => manage(sealed, { owner: sealed.address, action: "remove_owner", ownerGuid }),
     completeDeployment: (onStep, options) => deployments.run(onStep, options),
     isDeploying: () => deployments.isDeploying()
   };