kokio-sdk 2.1.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/eSIMWallet.eoa.js

@@ -2,15 +2,18 @@ import { _getChainSpecificConstants } from "../constants.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);
@@ -21,8 +24,7 @@ export const _buyDataBundle = async (client, eSIMWalletAddress, dataBundleDetail
         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/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: []
+    });
+};

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

@@ -456,22 +456,40 @@ export const _unpauseCall = async (client, target) => {
     };
 };
 /**
- * Set the fallback data bundle price ceiling. Pass the result to `schedule`.
+ * Set the fallback price ceiling, in USD cents. Pass the result to `schedule`.
  *
  * Zero reverts on execution, not on scheduling, so a zero here costs the whole
  * delay before it fails.
  *
  * `target` defaults to the registry.
  */
-export const _setDefaultDataBundlePriceCapCall = async (client, cap, target) => {
+export const _setDefaultPriceCapUSDCentsCall = async (client, cap, target) => {
     const values = await _resolve(client);
     return {
         address: target ?? values.factoryAddresses.REGISTRY,
         abi: Registry,
-        functionName: 'setDefaultDataBundlePriceCap',
+        functionName: 'setDefaultPriceCapUSDCents',
         args: [cap],
     };
 };
+/**
+ * Point the registry at a new payment adapter. Pass the result to `schedule`.
+ *
+ * Owner only, deliberately not the admin: the adapter holds the spent payment
+ * references, so an admin that could swap it would get an empty set back and
+ * could record every purchase a second time.
+ *
+ * `target` defaults to the registry.
+ */
+export const _setPaymentAdapterCall = async (client, paymentAdapter, target) => {
+    const values = await _resolve(client);
+    return {
+        address: target ?? values.factoryAddresses.REGISTRY,
+        abi: Registry,
+        functionName: 'setPaymentAdapter',
+        args: [paymentAdapter],
+    };
+};
 // ---------------------------------------------------------------------------
 // Admin suspension payloads - the owner's route, aimed at the target contract
 // ---------------------------------------------------------------------------

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

@@ -24,11 +24,11 @@ export const _isValidESIMWallet = async (client, deviceWalletAddress, eSIMWallet
     });
 };
 /** Whether an eSIM wallet is allowed to pull ETH from this device wallet. */
-export const _canPullETH = async (client, deviceWalletAddress, eSIMWallet) => {
+export const _canPullFunds = async (client, deviceWalletAddress, eSIMWallet) => {
     return client.extend(publicActions).readContract({
         address: deviceWalletAddress,
         abi: DeviceWallet,
-        functionName: "canPullETH",
+        functionName: "canPullFunds",
         args: [eSIMWallet]
     });
 };

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

@@ -26,13 +26,13 @@ export const _eSIMUniqueIdentifier = async (client, eSIMWalletAddress) => {
  * This wallet's own price ceiling in wei. Zero means it follows the registry's
  * `defaultDataBundlePriceCap` instead, which is the state a fresh wallet and a
  * newly handed-over wallet both start in. Worth reading before naming a price on
- * `buyDataBundle`, since a price over the ceiling reverts.
+ * `buyDataBundleWithToken`, since a price over the ceiling reverts.
  */
-export const _dataBundlePriceCap = async (client, eSIMWalletAddress) => {
+export const _priceCapUSDCents = async (client, eSIMWalletAddress) => {
     return client.extend(publicActions).readContract({
         address: eSIMWalletAddress,
         abi: ESIMWallet,
-        functionName: "dataBundlePriceCap",
+        functionName: "priceCapUSDCents",
         args: []
     });
 };
@@ -74,15 +74,16 @@ export const _deviceWallet = async (client, eSIMWalletAddress) => {
  *
  * The contract publishes no length getter, so there is no way to ask how many
  * entries exist. Read upwards from zero until a call reverts, or track the count
- * from the `DataBundleBought` and `TransactionHistoryPopulated` events, whose
- * `_totalEntries` is the length after the batch landed.
+ * from the `DataBundleBoughtWithToken`, `DataBundleSettlementRecorded` and
+ * `TransactionHistoryPopulated` events, whose `_totalEntries` is the length
+ * after the batch landed.
  */
 export const _transactionHistory = async (client, eSIMWalletAddress, index) => {
-    const [dataBundleID, dataBundlePrice] = await client.extend(publicActions).readContract({
+    const [id, priceUSDCents, settlement] = await client.extend(publicActions).readContract({
         address: eSIMWalletAddress,
         abi: ESIMWallet,
         functionName: "transactionHistory",
         args: [index]
     });
-    return { dataBundleID, dataBundlePrice };
+    return { id, priceUSDCents, settlement };
 };

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

@@ -38,13 +38,13 @@ export const _deviceIdentifierToESIMDetails = async (client, deviceIdentifier, e
     const chainID = await client.getChainId();
     const rpcURL = client.transport.url;
     const values = _getChainSpecificConstants(chainID, rpcURL);
-    const [dataBundleID, dataBundlePrice] = await client.extend(publicActions).readContract({
+    const [id, priceUSDCents, settlement] = await client.extend(publicActions).readContract({
         address: values.factoryAddresses.LAZY_WALLET_REGISTRY,
         abi: LazyWalletRegistry,
         functionName: "deviceIdentifierToESIMDetails",
         args: [deviceIdentifier, eSIMIdentifier, index]
     });
-    return { dataBundleID, dataBundlePrice };
+    return { id, priceUSDCents, settlement };
 };
 /** Most eSIM wallets one `deployLazyWalletAndSetESIMIdentifier` call will deploy. */
 export const _maxESIMWalletsPerCall = async (client) => {
@@ -125,6 +125,23 @@ export const _historyEntriesCopied = async (client, eSIMIdentifier) => {
         args: [eSIMIdentifier]
     });
 };
+/**
+ * History entries still waiting to be copied in for this eSIM. A wallet's own
+ * purchase paths (`buyDataBundleWithToken`, `recordSettledPurchase`) refuse a
+ * new entry while this is non-zero, since it would land ahead of history that
+ * has not arrived yet.
+ */
+export const _outstandingHistoryEntries = async (client, eSIMIdentifier) => {
+    const chainID = await client.getChainId();
+    const rpcURL = client.transport.url;
+    const values = _getChainSpecificConstants(chainID, rpcURL);
+    return client.extend(publicActions).readContract({
+        address: values.factoryAddresses.LAZY_WALLET_REGISTRY,
+        abi: LazyWalletRegistry,
+        functionName: "outstandingHistoryEntries",
+        args: [eSIMIdentifier]
+    });
+};
 /** Whether a device identifier has purchases recorded against it here. */
 export const _isDeviceIdentifierReserved = async (client, deviceIdentifier) => {
     const chainID = await client.getChainId();