kokio-sdk 2.0.0 → 3.0.0

package/dist/esm/admin/interface/paymentAdapterClass.js

@@ -0,0 +1,54 @@
+import { _registry, _settlementToken, _assets, _resolveAsset, _quote, _usedReferences, _upgradeManager } from "../../logic/admin/reads/paymentAdapter.reads.js";
+import { _registerAsset, _updateAsset, _registerAssetCall, _updateAssetCall, _transferOwnershipCall, _upgradeCall, _acceptOwnership } from "../../logic/admin/paymentAdapter.eoa.js";
+export class AdminPaymentAdapterSubPackage {
+    walletClient;
+    constructor(walletClient) {
+        this.walletClient = walletClient;
+    }
+    registry() {
+        return _registry(this.walletClient);
+    }
+    settlementToken() {
+        return _settlementToken(this.walletClient);
+    }
+    assets(symbol) {
+        return _assets(this.walletClient, symbol);
+    }
+    resolveAsset(symbol) {
+        return _resolveAsset(this.walletClient, symbol);
+    }
+    quote(symbol, priceUSDCents) {
+        return _quote(this.walletClient, symbol, priceUSDCents);
+    }
+    usedReferences(paymentReference) {
+        return _usedReferences(this.walletClient, paymentReference);
+    }
+    upgradeManager() {
+        return _upgradeManager(this.walletClient);
+    }
+    // Direct writes - only succeed if this wallet client is the owner. On the
+    // live deployment the owner is the ProtocolAdmin timelock, so these revert
+    // there; use the *Call builders below with `protocolAdmin.schedule` instead.
+    registerAsset(symbol, asset) {
+        return _registerAsset(this.walletClient, symbol, asset);
+    }
+    updateAsset(symbol, asset) {
+        return _updateAsset(this.walletClient, symbol, asset);
+    }
+    acceptOwnership() {
+        return _acceptOwnership(this.walletClient);
+    }
+    // Owner payloads - build an OwnerCall to hand to protocolAdmin.schedule.
+    registerAssetCall(symbol, asset) {
+        return _registerAssetCall(this.walletClient, symbol, asset);
+    }
+    updateAssetCall(symbol, asset) {
+        return _updateAssetCall(this.walletClient, symbol, asset);
+    }
+    transferOwnershipCall(newOwner) {
+        return _transferOwnershipCall(this.walletClient, newOwner);
+    }
+    upgradeCall(newImplementation, data) {
+        return _upgradeCall(this.walletClient, newImplementation, data);
+    }
+}

package/dist/esm/admin/interface/protocolAdminClass.js

@@ -1,4 +1,4 @@
-import { _operationId, _operationIdBatch, _operationIdRaw, _operationIdBatchRaw, _schedule, _scheduleBatch, _scheduleRaw, _execute, _executeBatch, _executeRaw, _cancel, _unpauseInstantly, _revokeCancellersInstantly, _disableAdminInstantly, _acceptOwnershipBatch, _renounceRole, _grantRoleCall, _revokeRoleCall, _updateDelayCall, _disableAndNominateCall, _disableAdminCall, _enableAdminCall, _unpauseCall, _setDefaultDataBundlePriceCapCall, } from "../../logic/admin/protocolAdmin.eoa.js";
+import { _operationId, _operationIdBatch, _operationIdRaw, _operationIdBatchRaw, _schedule, _scheduleBatch, _scheduleRaw, _execute, _executeBatch, _executeRaw, _cancel, _unpauseInstantly, _revokeCancellersInstantly, _disableAdminInstantly, _acceptOwnershipBatch, _renounceRole, _grantRoleCall, _revokeRoleCall, _updateDelayCall, _disableAndNominateCall, _disableAdminCall, _enableAdminCall, _unpauseCall, _setDefaultPriceCapUSDCentsCall, _setPaymentAdapterCall, } from "../../logic/admin/protocolAdmin.eoa.js";
 import { _getMinDelay, _minDelayFloor, _getOperationState, _getTimestamp, _isOperation, _isOperationPending, _isOperationReady, _isOperationDone, _hasRole, _getRoleAdmin, _defaultAdminRole, _proposerRole, _cancellerRole, _executorRole, _guardianRole, } from "../../logic/admin/reads/protocolAdmin.reads.js";
 /** Schedules operations. Needs an EOA holding `PROPOSER_ROLE`. */
 export class ProtocolAdminProposerSubPackage {
@@ -129,8 +129,11 @@ export class AdminProtocolAdminSubPackage {
     unpauseCall(target) {
         return _unpauseCall(this.walletClient, target);
     }
-    setDefaultDataBundlePriceCapCall(cap, target) {
-        return _setDefaultDataBundlePriceCapCall(this.walletClient, cap, target);
+    setDefaultPriceCapUSDCentsCall(cap, target) {
+        return _setDefaultPriceCapUSDCentsCall(this.walletClient, cap, target);
+    }
+    setPaymentAdapterCall(paymentAdapter, target) {
+        return _setPaymentAdapterCall(this.walletClient, paymentAdapter, target);
     }
     // Operation ids
     operationId(call, opts) {

package/dist/esm/admin/interface/registryClass.js

@@ -1,5 +1,5 @@
-import { _addOrUpdateLazyWalletRegistryAddress, _updateVaultAddress, _requestAdminUpdate, _disableAdmin, _enableAdmin, _acceptAdminUpdate, _assignESIMIdentifier, _pause, _unpause, _setDefaultDataBundlePriceCap, _acceptOwnership, _transferOwnershipCall, _upgradeCall, } from "../../logic/admin/registry.eoa.js";
-import { _owner, _eSIMWalletAdmin, _adminOfRecord, _adminDisabled, _newRequestedAdmin, _vault, _upgradeManager, _lazyWalletRegistry, _uniqueIdentifierToDeviceWallet, _deviceWalletToOwner, _registeredP256Keys, _isDeviceWalletValid, _isESIMWalletValid, _isESIMWalletOnStandby, _paused, _defaultDataBundlePriceCap, _isDeviceIdentifierAlreadyUsed, _isESIMIdentifierClaimed, _eSIMWalletForIdentifier, _claimedESIMIdentifiers, _requireDeviceIdentifierNotReserved, _pendingOwner, _deviceWalletFactory, _eSIMWalletFactory, _entryPoint, _requireNotPaused, _proxiableUUID, _upgradeInterfaceVersion, } from "../../logic/admin/reads/registry.reads.js";
+import { _addOrUpdateLazyWalletRegistryAddress, _updateVaultAddress, _requestAdminUpdate, _disableAdmin, _enableAdmin, _acceptAdminUpdate, _assignESIMIdentifier, _recordSettledPurchase, _pause, _unpause, _setDefaultPriceCapUSDCents, _acceptOwnership, _transferOwnershipCall, _upgradeCall, } from "../../logic/admin/registry.eoa.js";
+import { _owner, _eSIMWalletAdmin, _adminOfRecord, _adminDisabled, _newRequestedAdmin, _vault, _upgradeManager, _lazyWalletRegistry, _uniqueIdentifierToDeviceWallet, _deviceWalletToOwner, _registeredP256Keys, _isDeviceWalletValid, _isESIMWalletValid, _isESIMWalletOnStandby, _paused, _defaultPriceCapUSDCents, _paymentAdapter, _usedPaymentReferences, _isDeviceIdentifierAlreadyUsed, _isESIMIdentifierClaimed, _eSIMWalletForIdentifier, _claimedESIMIdentifiers, _requireDeviceIdentifierNotReserved, _pendingOwner, _deviceWalletFactory, _eSIMWalletFactory, _entryPoint, _requireNotPaused, _proxiableUUID, _upgradeInterfaceVersion, } from "../../logic/admin/reads/registry.reads.js";
 /** Thin EOA (owner) wrapper around `Registry`. */
 export class AdminRegistrySubPackage {
     walletClient;
@@ -24,6 +24,9 @@ export class AdminRegistrySubPackage {
     acceptAdminUpdate() {
         return _acceptAdminUpdate(this.walletClient);
     }
+    recordSettledPurchase(eSIMWalletAddress, dataBundleDetail, asset, tokenAmount, paymentReference) {
+        return _recordSettledPurchase(this.walletClient, eSIMWalletAddress, dataBundleDetail, asset, tokenAmount, paymentReference);
+    }
     assignESIMIdentifier(eSIMWalletAddress, eSIMUniqueIdentifier) {
         return _assignESIMIdentifier(this.walletClient, eSIMWalletAddress, eSIMUniqueIdentifier);
     }
@@ -33,8 +36,8 @@ export class AdminRegistrySubPackage {
     unpause() {
         return _unpause(this.walletClient);
     }
-    setDefaultDataBundlePriceCap(cap) {
-        return _setDefaultDataBundlePriceCap(this.walletClient, cap);
+    setDefaultPriceCapUSDCents(cap) {
+        return _setDefaultPriceCapUSDCents(this.walletClient, cap);
     }
     acceptOwnership() {
         return _acceptOwnership(this.walletClient);
@@ -92,8 +95,14 @@ export class AdminRegistrySubPackage {
     paused() {
         return _paused(this.walletClient);
     }
-    defaultDataBundlePriceCap() {
-        return _defaultDataBundlePriceCap(this.walletClient);
+    defaultPriceCapUSDCents() {
+        return _defaultPriceCapUSDCents(this.walletClient);
+    }
+    paymentAdapter() {
+        return _paymentAdapter(this.walletClient);
+    }
+    usedPaymentReferences(scopedReference) {
+        return _usedPaymentReferences(this.walletClient, scopedReference);
     }
     isDeviceIdentifierAlreadyUsed(deviceUniqueIdentifier) {
         return _isDeviceIdentifierAlreadyUsed(this.walletClient, deviceUniqueIdentifier);

package/dist/esm/config.js

@@ -6,6 +6,7 @@ import { RegistrySubPackage } from "./interface/registryClass.js";
 import { DeviceWalletSubPackage } from "./interface/deviceWalletClass.js";
 import { ESIMWalletSubPackage } from "./interface/eSIMWalletClass.js";
 import { ESIMWalletFactorySubPackage } from "./interface/eSIMWalletFactoryClass.js";
+import { PaymentAdapterSubPackage } from "./interface/paymentAdapterClass.js";
 // Re-export the typed error surface so consumers can `instanceof KokioError`
 // (or a specific subclass) and decode on-chain reverts without reaching into
 // internal module paths.
@@ -27,6 +28,7 @@ export class Kokio {
     deviceWallet;
     eSIMWallet;
     P256Verifier;
+    paymentAdapter;
     constructor(viemWalletClient, credentialId, rpId, pimlicoAPIKey, gasPolicyId, smartAccountClient, deviceWalletAddress, eSIMWalletAddress) {
         this.viemWalletClient = viemWalletClient;
         this.credentialId = credentialId;
@@ -42,6 +44,7 @@ export class Kokio {
         this.eSIMWalletFactory = smartAccountClient ? new ESIMWalletFactorySubPackage(viemWalletClient, smartAccountClient) : undefined;
         this.registry = smartAccountClient ? new RegistrySubPackage(smartAccountClient) : undefined;
         this.P256Verifier = smartAccountClient ? new P256VerifierSubPackage(smartAccountClient) : undefined;
+        this.paymentAdapter = smartAccountClient ? new PaymentAdapterSubPackage(smartAccountClient) : undefined;
         this.deviceWallet = deviceWalletAddress && smartAccountClient ? new DeviceWalletSubPackage(viemWalletClient, smartAccountClient, deviceWalletAddress) : undefined;
         this.eSIMWallet = eSIMWalletAddress && smartAccountClient ? new ESIMWalletSubPackage(smartAccountClient, eSIMWalletAddress) : undefined;
     }

package/dist/esm/interface/deviceWalletClass.js

@@ -1,4 +1,4 @@
-import { _addDeposit, _addESIMWallet, _canPullETH, _deviceUniqueIdentifier, _entryPoint, _eSIMWalletFactory, _getDeposit, _getOwner, _getVaultAddress, _isValidESIMWallet, _isValidSignature, _registry, _removeESIMWallet, _sendUserOperation, _toggleAccessToETH, _transferOwnership, _verifier, _withdrawDepositTo } from "../logic/deviceWallet.js";
+import { _addDeposit, _addESIMWallet, _canPullFunds, _deviceUniqueIdentifier, _entryPoint, _eSIMWalletFactory, _getDeposit, _getOwner, _getVaultAddress, _isValidESIMWallet, _isValidSignature, _registry, _removeESIMWallet, _sendUserOperation, _toggleAccessToFunds, _transferOwnership, _verifier, _withdrawDepositTo } from "../logic/deviceWallet.js";
 export class DeviceWalletSubPackage {
     smartAccountClient;
     walletClient;
@@ -23,8 +23,8 @@ export class DeviceWalletSubPackage {
     removeESIMWallet(eSIMWalletAddress, callBackETH) {
         return _removeESIMWallet(this.smartAccountClient, this.address, eSIMWalletAddress, callBackETH);
     }
-    toggleAccessToETH(eSIMWalletAddress, hasAccessToETH) {
-        return _toggleAccessToETH(this.smartAccountClient, this.address, eSIMWalletAddress, hasAccessToETH);
+    toggleAccessToFunds(eSIMWalletAddress, hasAccessToFunds) {
+        return _toggleAccessToFunds(this.smartAccountClient, this.address, eSIMWalletAddress, hasAccessToFunds);
     }
     transferOwnership(newOwner) {
         return _transferOwnership(this.smartAccountClient, this.address, newOwner);
@@ -33,8 +33,8 @@ export class DeviceWalletSubPackage {
         return _withdrawDepositTo(this.smartAccountClient, this.address, withdrawAddress, amount);
     }
     // Reads
-    canPullETH(eSIMWalletAddress) {
-        return _canPullETH(this.smartAccountClient, this.address, eSIMWalletAddress);
+    canPullFunds(eSIMWalletAddress) {
+        return _canPullFunds(this.smartAccountClient, this.address, eSIMWalletAddress);
     }
     deviceUniqueIdentifier() {
         return _deviceUniqueIdentifier(this.smartAccountClient, this.address);

package/dist/esm/interface/eSIMWalletClass.js

@@ -1,4 +1,4 @@
-import { _acceptOwnershipTransfer, _buyDataBundle, _dataBundlePriceCap, _deviceWallet, _owner, _requestTransferOwnership, _sendETHToDeviceWallet, _setDataBundlePriceCap, _transactionHistory } from "../logic/eSIMWallet.js";
+import { _acceptOwnershipTransfer, _buyDataBundleWithToken, _priceCapUSDCents, _deviceWallet, _owner, _requestTransferOwnership, _sendETHToDeviceWallet, _sendTokenToDeviceWallet, _setPriceCapUSDCents, _transactionHistory } from "../logic/eSIMWallet.js";
 export class ESIMWalletSubPackage {
     client;
     address;
@@ -9,11 +9,11 @@ export class ESIMWalletSubPackage {
     acceptOwnershipTransfer() {
         return _acceptOwnershipTransfer(this.client, this.address);
     }
-    buyDataBundle(dataBundleDetails) {
-        return _buyDataBundle(this.client, this.address, dataBundleDetails);
+    buyDataBundleWithToken(dataBundleDetails, asset, maxAmountIn, paymentReference) {
+        return _buyDataBundleWithToken(this.client, this.address, dataBundleDetails, asset, maxAmountIn, paymentReference);
     }
-    dataBundlePriceCap() {
-        return _dataBundlePriceCap(this.client, this.address);
+    priceCapUSDCents() {
+        return _priceCapUSDCents(this.client, this.address);
     }
     deviceWallet() {
         return _deviceWallet(this.client, this.address);
@@ -27,8 +27,11 @@ export class ESIMWalletSubPackage {
     sendETHToDeviceWallet(amount) {
         return _sendETHToDeviceWallet(this.client, this.address, amount);
     }
-    setDataBundlePriceCap(cap) {
-        return _setDataBundlePriceCap(this.client, this.address, cap);
+    sendTokenToDeviceWallet(token, amount) {
+        return _sendTokenToDeviceWallet(this.client, this.address, token, amount);
+    }
+    setPriceCapUSDCents(cap) {
+        return _setPriceCapUSDCents(this.client, this.address, cap);
     }
     transactionHistory(index) {
         return _transactionHistory(this.client, this.address, index);

package/dist/esm/interface/paymentAdapterClass.js

@@ -0,0 +1,28 @@
+import { _registry, _settlementToken, _assets, _resolveAsset, _quote, _usedReferences, _upgradeManager } from "../logic/paymentAdapter.js";
+export class PaymentAdapterSubPackage {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    registry() {
+        return _registry(this.client);
+    }
+    settlementToken() {
+        return _settlementToken(this.client);
+    }
+    assets(symbol) {
+        return _assets(this.client, symbol);
+    }
+    resolveAsset(symbol) {
+        return _resolveAsset(this.client, symbol);
+    }
+    quote(symbol, priceUSDCents) {
+        return _quote(this.client, symbol, priceUSDCents);
+    }
+    usedReferences(paymentReference) {
+        return _usedReferences(this.client, paymentReference);
+    }
+    upgradeManager() {
+        return _upgradeManager(this.client);
+    }
+}

package/dist/esm/interface/registryClass.js

@@ -1,4 +1,4 @@
-import { _bindESIMWallet, _toggleESIMWalletStandbyStatus, _isDeviceIdentifierAlreadyUsed, _paused, _requireNotPaused, _isESIMWalletValid, _isESIMWalletOnStandby, _isDeviceWalletValid, _uniqueIdentifierToDeviceWallet, _isESIMIdentifierClaimed, _eSIMWalletForIdentifier, _defaultDataBundlePriceCap, _requireDeviceIdentifierNotReserved } from "../logic/registry.js";
+import { _bindESIMWallet, _toggleESIMWalletStandbyStatus, _isDeviceIdentifierAlreadyUsed, _paused, _requireNotPaused, _isESIMWalletValid, _isESIMWalletOnStandby, _isDeviceWalletValid, _uniqueIdentifierToDeviceWallet, _isESIMIdentifierClaimed, _eSIMWalletForIdentifier, _defaultPriceCapUSDCents, _paymentAdapter, _usedPaymentReferences, _requireLazyHistoryCopied, _requireDeviceIdentifierNotReserved } from "../logic/registry.js";
 export class RegistrySubPackage {
     client;
     constructor(client) {
@@ -38,8 +38,17 @@ export class RegistrySubPackage {
     eSIMWalletForIdentifier(eSIMUniqueIdentifier) {
         return _eSIMWalletForIdentifier(this.client, eSIMUniqueIdentifier);
     }
-    defaultDataBundlePriceCap() {
-        return _defaultDataBundlePriceCap(this.client);
+    defaultPriceCapUSDCents() {
+        return _defaultPriceCapUSDCents(this.client);
+    }
+    paymentAdapter() {
+        return _paymentAdapter(this.client);
+    }
+    usedPaymentReferences(scopedReference) {
+        return _usedPaymentReferences(this.client, scopedReference);
+    }
+    requireLazyHistoryCopied(eSIMWallet) {
+        return _requireLazyHistoryCopied(this.client, eSIMWallet);
     }
     requireDeviceIdentifierNotReserved(deviceUniqueIdentifier) {
         return _requireDeviceIdentifierNotReserved(this.client, deviceUniqueIdentifier);

package/dist/esm/logic/admin/deviceWallet.eoa.js

@@ -1,5 +1,5 @@
 import { _getChainSpecificConstants } from "../constants.js";
-import { MissingEOAWalletError } from "../errors.js";
+import { MissingEOAWalletError, writeContractOrThrow } from "../errors.js";
 import { DeviceWallet } from "../../abis/index.js";
 // Admin-EOA logic targeting a specific `DeviceWallet` instance (its address is
 // passed in - there is no single factory address). `deployESIMWallet` is
@@ -19,7 +19,7 @@ export const _deployESIMWallet = async (client, deviceWalletAddress, salt) => {
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: deviceWalletAddress,
         chain: values.chain,
         account: client.account.address,
@@ -41,7 +41,7 @@ export const _addDeposit = async (client, deviceWalletAddress, amount) => {
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: deviceWalletAddress,
         chain: values.chain,
         account: client.account.address,

package/dist/esm/logic/admin/deviceWalletFactory.eoa.js

@@ -1,5 +1,5 @@
 import { _getChainSpecificConstants } from "../constants.js";
-import { MissingEOAWalletError } from "../errors.js";
+import { MissingEOAWalletError, writeContractOrThrow } from "../errors.js";
 import { DeviceWalletFactory } from "../../abis/index.js";
 // Admin-EOA logic for `DeviceWalletFactory`.
 //
@@ -24,7 +24,7 @@ export const _deployDeviceWalletForUsers = async (client, deviceUniqueIdentifier
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.DEVICE_WALLET_FACTORY,
         chain: values.chain,
         account: client.account.address,
@@ -45,7 +45,7 @@ export const _postCreateAccount = async (client, deviceWallet, deviceUniqueIdent
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.DEVICE_WALLET_FACTORY,
         chain: values.chain,
         account: client.account.address,
@@ -61,7 +61,7 @@ export const _addRegistryAddress = async (client, registryContractAddress) => {
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.DEVICE_WALLET_FACTORY,
         chain: values.chain,
         account: client.account.address,
@@ -77,7 +77,7 @@ export const _updateDeviceWalletImplementation = async (client, newDeviceImpl) =
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.DEVICE_WALLET_FACTORY,
         chain: values.chain,
         account: client.account.address,
@@ -143,7 +143,7 @@ export const _acceptOwnership = async (client) => {
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.DEVICE_WALLET_FACTORY,
         chain: values.chain,
         account: client.account.address,

package/dist/esm/logic/admin/eSIMWallet.eoa.js

@@ -1,28 +1,30 @@
 import { _getChainSpecificConstants } from "../constants.js";
-import { MissingEOAWalletError } from "../errors.js";
+import { MissingEOAWalletError, writeContractOrThrow } from "../errors.js";
 import { ESIMWallet } from "../../abis/index.js";
 // Admin-EOA logic targeting a specific `ESIMWallet` instance (address passed in).
-// `buyDataBundle` is `onlyDeviceWalletOrESIMWalletAdmin`, so the admin EOA can
-// call it directly.
+// `buyDataBundleWithToken` is `onlyDeviceWalletOrESIMWalletAdmin`, so the admin
+// EOA can call it directly.
 /**
- * Buy a data bundle for an eSIM wallet. `onlyDeviceWalletOrESIMWalletAdmin`,
- * `payable`. `value` is optional: the contract pulls any shortfall from the
- * device wallet's balance, so an admin can pass `0n` when the wallet is funded,
- * or forward `dataBundlePrice` to pay directly.
+ * Buy a data bundle in `asset`, an ERC-20 the payment adapter accepts.
+ * `onlyDeviceWalletOrESIMWalletAdmin`.
+ *
+ * `maxAmountIn` is the most of `asset` the buyer will spend, in its smallest
+ * unit - read it from `paymentAdapter.quote(asset, dataBundleDetails.priceUSDCents)`
+ * first. `paymentReference` ties this purchase to its offchain order and is
+ * spendable once per eSIM wallet.
  */
-export const _buyDataBundle = async (client, eSIMWalletAddress, dataBundleDetails, value = 0n) => {
+export const _buyDataBundleWithToken = async (client, eSIMWalletAddress, dataBundleDetails, asset, maxAmountIn, paymentReference) => {
     const chainID = await client.getChainId();
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: eSIMWalletAddress,
         chain: values.chain,
         account: client.account.address,
         abi: ESIMWallet,
-        functionName: 'buyDataBundle',
-        args: [dataBundleDetails],
-        value
+        functionName: 'buyDataBundleWithToken',
+        args: [dataBundleDetails, asset, maxAmountIn, paymentReference]
     });
 };

package/dist/esm/logic/admin/eSIMWalletFactory.eoa.js

@@ -1,5 +1,5 @@
 import { _getChainSpecificConstants } from "../constants.js";
-import { MissingEOAWalletError } from "../errors.js";
+import { MissingEOAWalletError, writeContractOrThrow } from "../errors.js";
 import { ESIMWalletFactory } from "../../abis/index.js";
 // Admin-EOA logic for `ESIMWalletFactory`. Both functions are owner-gated
 // (`addRegistryAddress` requires `msg.sender == owner()`, `updateESIMWalletImplementation`
@@ -19,7 +19,7 @@ export const _addRegistryAddress = async (client, registryContractAddress) => {
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.ESIM_WALLET_FACTORY,
         chain: values.chain,
         account: client.account.address,
@@ -35,7 +35,7 @@ export const _updateESIMWalletImplementation = async (client, eSIMWalletImpl) =>
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.ESIM_WALLET_FACTORY,
         chain: values.chain,
         account: client.account.address,
@@ -100,7 +100,7 @@ export const _acceptOwnership = async (client) => {
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.ESIM_WALLET_FACTORY,
         chain: values.chain,
         account: client.account.address,

package/dist/esm/logic/admin/lazyWalletRegistry.eoa.js

@@ -1,6 +1,6 @@
 import { BaseError, ContractFunctionRevertedError, isAddressEqual, parseEventLogs, publicActions, } from "viem";
 import { _getChainSpecificConstants } from "../constants.js";
-import { BatchSizeOutOfRangeError, DepositOnResumeError, ESIMWalletNotLazyDeployedError, MissingBatchEventError, MissingEOAWalletError, StalledBatchError, } from "../errors.js";
+import { BatchSizeOutOfRangeError, DepositOnResumeError, ESIMWalletNotLazyDeployedError, MissingBatchEventError, MissingEOAWalletError, StalledBatchError, writeContractOrThrow, } from "../errors.js";
 import { LazyWalletRegistry, Registry } from "../../abis/index.js";
 import { _eSIMWalletsDeployed, _lazyDeployedESIMWallet } from "./reads/lazyWalletRegistry.reads.js";
 // Admin-EOA logic for `LazyWalletRegistry`. Every function here is
@@ -45,7 +45,7 @@ export const _batchPopulateHistory = async (client, deviceUniqueIdentifiers, eSI
     const values = await _resolve(client);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.LAZY_WALLET_REGISTRY,
         chain: values.chain,
         account: client.account.address,
@@ -67,7 +67,7 @@ export const _deployLazyWalletAndSetESIMIdentifier = async (client, deviceOwnerP
     const values = await _resolve(client);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.LAZY_WALLET_REGISTRY,
         chain: values.chain,
         account: client.account.address,
@@ -90,7 +90,7 @@ export const _deployMoreESIMWalletsForLazyDevice = async (client, deviceUniqueId
     const values = await _resolve(client);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.LAZY_WALLET_REGISTRY,
         chain: values.chain,
         account: client.account.address,
@@ -110,7 +110,7 @@ export const _setHistoryForLazyWallet = async (client, eSIMIdentifier, maxEntrie
     const values = await _resolve(client);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.LAZY_WALLET_REGISTRY,
         chain: values.chain,
         account: client.account.address,
@@ -124,7 +124,7 @@ export const _switchESIMIdentifierToNewDeviceIdentifier = async (client, eSIMIde
     const values = await _resolve(client);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.LAZY_WALLET_REGISTRY,
         chain: values.chain,
         account: client.account.address,
@@ -362,7 +362,7 @@ export const _acceptOwnership = async (client) => {
     const values = _getChainSpecificConstants(chainID, rpcURL);
     if (!client.account)
         throw new MissingEOAWalletError();
-    return client.writeContract({
+    return writeContractOrThrow(client, {
         address: values.factoryAddresses.LAZY_WALLET_REGISTRY,
         chain: values.chain,
         account: client.account.address,

package/dist/esm/logic/admin/paymentAdapter.eoa.js

@@ -0,0 +1,123 @@
+import { _getChainSpecificConstants } from "../constants.js";
+import { MissingEOAWalletError, writeContractOrThrow } from "../errors.js";
+import { PaymentAdapter } from "../../abis/index.js";
+// Admin-EOA logic for `PaymentAdapter`. `registerAsset`/`updateAsset` are
+// `onlyOwner`, so the `client` must carry the `upgradeManager` EOA.
+//
+// On the live deployment the owner is the `ProtocolAdmin` timelock, not an EOA,
+// so either call sent directly reverts. Route them through
+// `protocolAdmin.proposer.schedule` instead, via the payload builders below.
+/** Add a currency the adapter has never seen. Reverts if `_symbol` is already registered. Owner only. */
+export const _registerAsset = async (client, symbol, asset) => {
+    const chainID = await client.getChainId();
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    if (!client.account)
+        throw new MissingEOAWalletError();
+    return writeContractOrThrow(client, {
+        address: values.factoryAddresses.PAYMENT_ADAPTER,
+        chain: values.chain,
+        account: client.account.address,
+        abi: PaymentAdapter,
+        functionName: 'registerAsset',
+        args: [symbol, asset]
+    });
+};
+/** Change a currency already in the table (its decimals, token, or allowed flag). Owner only. */
+export const _updateAsset = async (client, symbol, asset) => {
+    const chainID = await client.getChainId();
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    if (!client.account)
+        throw new MissingEOAWalletError();
+    return writeContractOrThrow(client, {
+        address: values.factoryAddresses.PAYMENT_ADAPTER,
+        chain: values.chain,
+        account: client.account.address,
+        abi: PaymentAdapter,
+        functionName: 'updateAsset',
+        args: [symbol, asset]
+    });
+};
+// ---------------------------------------------------------------------------
+// Owner payloads - only reachable through schedule
+// ---------------------------------------------------------------------------
+// All `onlyOwner`, and on the live deployment the owner is the timelock, so they
+// exist as something to schedule rather than to send. Each returns the
+// `OwnerCall` to hand to `protocolAdmin.schedule`.
+/** Add or change a currency, scheduled through the timelock. Pass the result to `schedule`. */
+export const _registerAssetCall = async (client, symbol, asset) => {
+    const chainID = await client.getChainId();
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    return {
+        address: values.factoryAddresses.PAYMENT_ADAPTER,
+        abi: PaymentAdapter,
+        functionName: 'registerAsset',
+        args: [symbol, asset],
+    };
+};
+/** Change a currency already in the table, scheduled through the timelock. Pass the result to `schedule`. */
+export const _updateAssetCall = async (client, symbol, asset) => {
+    const chainID = await client.getChainId();
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    return {
+        address: values.factoryAddresses.PAYMENT_ADAPTER,
+        abi: PaymentAdapter,
+        functionName: 'updateAsset',
+        args: [symbol, asset],
+    };
+};
+/**
+ * Offer ownership to a new address. Pass the result to `schedule`.
+ *
+ * Ownable2Step, so the offer changes nothing until the named address calls
+ * `acceptOwnership`.
+ */
+export const _transferOwnershipCall = async (client, newOwner) => {
+    const chainID = await client.getChainId();
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    return {
+        address: values.factoryAddresses.PAYMENT_ADAPTER,
+        abi: PaymentAdapter,
+        functionName: 'transferOwnership',
+        args: [newOwner],
+    };
+};
+/** Point the adapter's proxy at a new implementation. Builds `upgradeToAndCall`. Pass the result to `schedule`. */
+export const _upgradeCall = async (client, newImplementation, data = '0x') => {
+    const chainID = await client.getChainId();
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    return {
+        address: values.factoryAddresses.PAYMENT_ADAPTER,
+        abi: PaymentAdapter,
+        functionName: 'upgradeToAndCall',
+        args: [newImplementation, data],
+    };
+};
+/**
+ * Take ownership after a `transferOwnership` named this client. `msg.sender`
+ * must equal `pendingOwner`, so the `client` is the incoming owner.
+ *
+ * Where the incoming owner is the timelock, use
+ * `protocolAdmin.acceptOwnershipBatch` instead, which accepts for every
+ * contract at once.
+ */
+export const _acceptOwnership = async (client) => {
+    const chainID = await client.getChainId();
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    if (!client.account)
+        throw new MissingEOAWalletError();
+    return writeContractOrThrow(client, {
+        address: values.factoryAddresses.PAYMENT_ADAPTER,
+        chain: values.chain,
+        account: client.account.address,
+        abi: PaymentAdapter,
+        functionName: 'acceptOwnership',
+        args: []
+    });
+};