kokio-sdk 2.1.0 → 3.0.0

package/dist/esm/abis/Registry.js

@@ -140,13 +140,26 @@ const Registry = [
     },
     {
         "type": "function",
-        "name": "defaultDataBundlePriceCap",
+        "name": "consumePaymentReference",
+        "inputs": [
+            {
+                "name": "_paymentReference",
+                "type": "bytes32",
+                "internalType": "bytes32"
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "nonpayable"
+    },
+    {
+        "type": "function",
+        "name": "defaultPriceCapUSDCents",
         "inputs": [],
         "outputs": [
             {
                 "name": "",
-                "type": "uint256",
-                "internalType": "uint256"
+                "type": "uint64",
+                "internalType": "uint64"
             }
         ],
         "stateMutability": "view"
@@ -378,9 +391,9 @@ const Registry = [
                 "internalType": "contract IEntryPoint"
             },
             {
-                "name": "_defaultDataBundlePriceCap",
-                "type": "uint256",
-                "internalType": "uint256"
+                "name": "_defaultPriceCapUSDCents",
+                "type": "uint64",
+                "internalType": "uint64"
             }
         ],
         "outputs": [],
@@ -540,6 +553,19 @@ const Registry = [
         ],
         "stateMutability": "view"
     },
+    {
+        "type": "function",
+        "name": "paymentAdapter",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "address",
+                "internalType": "address"
+            }
+        ],
+        "stateMutability": "view"
+    },
     {
         "type": "function",
         "name": "pendingOwner",
@@ -568,14 +594,19 @@ const Registry = [
                 "internalType": "struct DataBundleDetails[]",
                 "components": [
                     {
-                        "name": "dataBundleID",
-                        "type": "string",
-                        "internalType": "string"
+                        "name": "id",
+                        "type": "bytes32",
+                        "internalType": "bytes32"
+                    },
+                    {
+                        "name": "priceUSDCents",
+                        "type": "uint64",
+                        "internalType": "uint64"
                     },
                     {
-                        "name": "dataBundlePrice",
-                        "type": "uint256",
-                        "internalType": "uint256"
+                        "name": "settlement",
+                        "type": "uint8",
+                        "internalType": "enum Settlement"
                     }
                 ]
             }
@@ -596,6 +627,56 @@ const Registry = [
         ],
         "stateMutability": "view"
     },
+    {
+        "type": "function",
+        "name": "recordSettledPurchase",
+        "inputs": [
+            {
+                "name": "_eSIMWallet",
+                "type": "address",
+                "internalType": "address"
+            },
+            {
+                "name": "_dataBundleDetail",
+                "type": "tuple",
+                "internalType": "struct DataBundleDetails",
+                "components": [
+                    {
+                        "name": "id",
+                        "type": "bytes32",
+                        "internalType": "bytes32"
+                    },
+                    {
+                        "name": "priceUSDCents",
+                        "type": "uint64",
+                        "internalType": "uint64"
+                    },
+                    {
+                        "name": "settlement",
+                        "type": "uint8",
+                        "internalType": "enum Settlement"
+                    }
+                ]
+            },
+            {
+                "name": "_asset",
+                "type": "bytes32",
+                "internalType": "bytes32"
+            },
+            {
+                "name": "_tokenAmount",
+                "type": "uint256",
+                "internalType": "uint256"
+            },
+            {
+                "name": "_paymentReference",
+                "type": "bytes32",
+                "internalType": "bytes32"
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "nonpayable"
+    },
     {
         "type": "function",
         "name": "registeredP256Keys",
@@ -648,6 +729,19 @@ const Registry = [
         "outputs": [],
         "stateMutability": "view"
     },
+    {
+        "type": "function",
+        "name": "requireLazyHistoryCopied",
+        "inputs": [
+            {
+                "name": "_eSIMWallet",
+                "type": "address",
+                "internalType": "address"
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "view"
+    },
     {
         "type": "function",
         "name": "requireNotPaused",
@@ -657,12 +751,25 @@ const Registry = [
     },
     {
         "type": "function",
-        "name": "setDefaultDataBundlePriceCap",
+        "name": "setDefaultPriceCapUSDCents",
         "inputs": [
             {
                 "name": "_cap",
-                "type": "uint256",
-                "internalType": "uint256"
+                "type": "uint64",
+                "internalType": "uint64"
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "nonpayable"
+    },
+    {
+        "type": "function",
+        "name": "setPaymentAdapter",
+        "inputs": [
+            {
+                "name": "_paymentAdapter",
+                "type": "address",
+                "internalType": "address"
             }
         ],
         "outputs": [],
@@ -811,6 +918,25 @@ const Registry = [
         "outputs": [],
         "stateMutability": "payable"
     },
+    {
+        "type": "function",
+        "name": "usedPaymentReferences",
+        "inputs": [
+            {
+                "name": "scopedReference",
+                "type": "bytes32",
+                "internalType": "bytes32"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "used",
+                "type": "bool",
+                "internalType": "bool"
+            }
+        ],
+        "stateMutability": "view"
+    },
     {
         "type": "function",
         "name": "vault",
@@ -915,13 +1041,68 @@ const Registry = [
     },
     {
         "type": "event",
-        "name": "DefaultDataBundlePriceCapUpdated",
+        "name": "DataBundleSettled",
         "inputs": [
             {
-                "name": "_cap",
+                "name": "_eSIMWallet",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_dataBundleID",
+                "type": "bytes32",
+                "indexed": false,
+                "internalType": "bytes32"
+            },
+            {
+                "name": "_priceUSDCents",
+                "type": "uint64",
+                "indexed": false,
+                "internalType": "uint64"
+            },
+            {
+                "name": "_settlement",
+                "type": "uint8",
+                "indexed": false,
+                "internalType": "enum Settlement"
+            },
+            {
+                "name": "_asset",
+                "type": "bytes32",
+                "indexed": true,
+                "internalType": "bytes32"
+            },
+            {
+                "name": "_token",
+                "type": "address",
+                "indexed": false,
+                "internalType": "address"
+            },
+            {
+                "name": "_tokenAmount",
                 "type": "uint256",
                 "indexed": false,
                 "internalType": "uint256"
+            },
+            {
+                "name": "_paymentReference",
+                "type": "bytes32",
+                "indexed": true,
+                "internalType": "bytes32"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "DefaultPriceCapUSDCentsUpdated",
+        "inputs": [
+            {
+                "name": "_cap",
+                "type": "uint64",
+                "indexed": false,
+                "internalType": "uint64"
             }
         ],
         "anonymous": false
@@ -1121,6 +1302,38 @@ const Registry = [
         ],
         "anonymous": false
     },
+    {
+        "type": "event",
+        "name": "PaymentAdapterUpdated",
+        "inputs": [
+            {
+                "name": "_paymentAdapter",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "PaymentReferenceConsumed",
+        "inputs": [
+            {
+                "name": "_eSIMWallet",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_paymentReference",
+                "type": "bytes32",
+                "indexed": true,
+                "internalType": "bytes32"
+            }
+        ],
+        "anonymous": false
+    },
     {
         "type": "event",
         "name": "RegistryInitialized",
@@ -1173,7 +1386,7 @@ const Registry = [
     },
     {
         "type": "event",
-        "name": "UpdatedDeviceWalletassociatedWithESIMWallet",
+        "name": "UpdatedDeviceWalletAssociatedWithESIMWallet",
         "inputs": [
             {
                 "name": "_eSIMWalletAddress",
@@ -1347,16 +1560,42 @@ const Registry = [
             }
         ]
     },
+    {
+        "type": "error",
+        "name": "EmptyDataBundleID",
+        "inputs": []
+    },
     {
         "type": "error",
         "name": "EmptyESIMIdentifier",
         "inputs": []
     },
+    {
+        "type": "error",
+        "name": "EmptyPaymentReference",
+        "inputs": []
+    },
     {
         "type": "error",
         "name": "FailedCall",
         "inputs": []
     },
+    {
+        "type": "error",
+        "name": "HistoryNotFullyCopied",
+        "inputs": [
+            {
+                "name": "eSIMIdentifier",
+                "type": "string",
+                "internalType": "string"
+            },
+            {
+                "name": "outstanding",
+                "type": "uint256",
+                "internalType": "uint256"
+            }
+        ]
+    },
     {
         "type": "error",
         "name": "InvalidInitialization",
@@ -1485,11 +1724,43 @@ const Registry = [
         "name": "OwnershipCannotBeRenounced",
         "inputs": []
     },
+    {
+        "type": "error",
+        "name": "PaymentAdapterNotSet",
+        "inputs": []
+    },
+    {
+        "type": "error",
+        "name": "PaymentAdapterUnchanged",
+        "inputs": [
+            {
+                "name": "paymentAdapter",
+                "type": "address",
+                "internalType": "address"
+            }
+        ]
+    },
+    {
+        "type": "error",
+        "name": "PaymentReferenceAlreadyUsed",
+        "inputs": [
+            {
+                "name": "paymentReference",
+                "type": "bytes32",
+                "internalType": "bytes32"
+            }
+        ]
+    },
     {
         "type": "error",
         "name": "ProtocolPaused",
         "inputs": []
     },
+    {
+        "type": "error",
+        "name": "SettlementNotAsserted",
+        "inputs": []
+    },
     {
         "type": "error",
         "name": "UUPSUnauthorizedCallContext",
@@ -1539,6 +1810,11 @@ const Registry = [
             }
         ]
     },
+    {
+        "type": "error",
+        "name": "ZeroDataBundlePrice",
+        "inputs": []
+    },
     {
         "type": "error",
         "name": "ZeroDataBundlePriceCap",

package/dist/esm/abis/RegistryHelper.js

@@ -293,14 +293,19 @@ const RegistryHelper = [
                 "internalType": "struct DataBundleDetails[]",
                 "components": [
                     {
-                        "name": "dataBundleID",
-                        "type": "string",
-                        "internalType": "string"
+                        "name": "id",
+                        "type": "bytes32",
+                        "internalType": "bytes32"
                     },
                     {
-                        "name": "dataBundlePrice",
-                        "type": "uint256",
-                        "internalType": "uint256"
+                        "name": "priceUSDCents",
+                        "type": "uint64",
+                        "internalType": "uint64"
+                    },
+                    {
+                        "name": "settlement",
+                        "type": "uint8",
+                        "internalType": "enum Settlement"
                     }
                 ]
             }
@@ -437,13 +442,68 @@ const RegistryHelper = [
     },
     {
         "type": "event",
-        "name": "DefaultDataBundlePriceCapUpdated",
+        "name": "DataBundleSettled",
         "inputs": [
             {
-                "name": "_cap",
+                "name": "_eSIMWallet",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_dataBundleID",
+                "type": "bytes32",
+                "indexed": false,
+                "internalType": "bytes32"
+            },
+            {
+                "name": "_priceUSDCents",
+                "type": "uint64",
+                "indexed": false,
+                "internalType": "uint64"
+            },
+            {
+                "name": "_settlement",
+                "type": "uint8",
+                "indexed": false,
+                "internalType": "enum Settlement"
+            },
+            {
+                "name": "_asset",
+                "type": "bytes32",
+                "indexed": true,
+                "internalType": "bytes32"
+            },
+            {
+                "name": "_token",
+                "type": "address",
+                "indexed": false,
+                "internalType": "address"
+            },
+            {
+                "name": "_tokenAmount",
                 "type": "uint256",
                 "indexed": false,
                 "internalType": "uint256"
+            },
+            {
+                "name": "_paymentReference",
+                "type": "bytes32",
+                "indexed": true,
+                "internalType": "bytes32"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "DefaultPriceCapUSDCentsUpdated",
+        "inputs": [
+            {
+                "name": "_cap",
+                "type": "uint64",
+                "indexed": false,
+                "internalType": "uint64"
             }
         ],
         "anonymous": false
@@ -592,6 +652,38 @@ const RegistryHelper = [
         ],
         "anonymous": false
     },
+    {
+        "type": "event",
+        "name": "PaymentAdapterUpdated",
+        "inputs": [
+            {
+                "name": "_paymentAdapter",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            }
+        ],
+        "anonymous": false
+    },
+    {
+        "type": "event",
+        "name": "PaymentReferenceConsumed",
+        "inputs": [
+            {
+                "name": "_eSIMWallet",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "_paymentReference",
+                "type": "bytes32",
+                "indexed": true,
+                "internalType": "bytes32"
+            }
+        ],
+        "anonymous": false
+    },
     {
         "type": "event",
         "name": "RegistryInitialized",
@@ -644,7 +736,7 @@ const RegistryHelper = [
     },
     {
         "type": "event",
-        "name": "UpdatedDeviceWalletassociatedWithESIMWallet",
+        "name": "UpdatedDeviceWalletAssociatedWithESIMWallet",
         "inputs": [
             {
                 "name": "_eSIMWalletAddress",

package/dist/esm/abis/index.js

@@ -8,4 +8,5 @@ import Registry from './Registry.js';
 import RegistryHelper from './RegistryHelper.js';
 import BeaconProxy from './BeaconProxy.js';
 import ProtocolAdmin from './ProtocolAdmin.js';
-export { DeviceWallet, DeviceWalletFactory, ESIMWallet, ESIMWalletFactory, LazyWalletRegistry, P256Verifier, Registry, RegistryHelper, BeaconProxy, ProtocolAdmin };
+import PaymentAdapter from './PaymentAdapter.js';
+export { DeviceWallet, DeviceWalletFactory, ESIMWallet, ESIMWalletFactory, LazyWalletRegistry, P256Verifier, Registry, RegistryHelper, BeaconProxy, ProtocolAdmin, PaymentAdapter };

package/dist/esm/admin/config-admin.js

@@ -6,6 +6,7 @@ import { AdminLazyWalletRegistrySubPackage } from "./interface/lazyWalletRegistr
 import { AdminProtocolAdminSubPackage } from "./interface/protocolAdminClass.js";
 import { AdminDeviceWalletSubPackage } from "./interface/deviceWalletClass.js";
 import { AdminESIMWalletSubPackage } from "./interface/eSIMWalletClass.js";
+import { AdminPaymentAdapterSubPackage } from "./interface/paymentAdapterClass.js";
 // Re-export the typed error surface so backend consumers can `instanceof
 // KokioError` (or a subclass) and decode reverts without reaching into internal
 // module paths - mirroring `config.ts`.
@@ -40,6 +41,7 @@ export class KokioAdmin {
     registry;
     lazyWalletRegistry;
     protocolAdmin;
+    paymentAdapter;
     // Instance-scoped surfaces - undefined until their address is known.
     deviceWallet;
     eSIMWallet;
@@ -53,6 +55,7 @@ export class KokioAdmin {
         this.registry = new AdminRegistrySubPackage(walletClient);
         this.lazyWalletRegistry = new AdminLazyWalletRegistrySubPackage(walletClient);
         this.protocolAdmin = new AdminProtocolAdminSubPackage(walletClient);
+        this.paymentAdapter = new AdminPaymentAdapterSubPackage(walletClient);
         this.deviceWallet = deviceWalletAddress ? new AdminDeviceWalletSubPackage(walletClient, deviceWalletAddress) : undefined;
         this.eSIMWallet = eSIMWalletAddress ? new AdminESIMWalletSubPackage(walletClient, eSIMWalletAddress) : undefined;
     }
@@ -102,6 +105,7 @@ export class KokioAdmin {
         this.registry = new AdminRegistrySubPackage(walletClient);
         this.lazyWalletRegistry = new AdminLazyWalletRegistrySubPackage(walletClient);
         this.protocolAdmin = new AdminProtocolAdminSubPackage(walletClient);
+        this.paymentAdapter = new AdminPaymentAdapterSubPackage(walletClient);
         this.deviceWallet = this.deviceWalletAddress ? new AdminDeviceWalletSubPackage(walletClient, this.deviceWalletAddress) : undefined;
         this.eSIMWallet = this.eSIMWalletAddress ? new AdminESIMWalletSubPackage(walletClient, this.eSIMWalletAddress) : undefined;
         return this;

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

@@ -1,5 +1,5 @@
 import { _addDeposit, _deployESIMWallet } from "../../logic/admin/deviceWallet.eoa.js";
-import { _deviceUniqueIdentifier, _isValidESIMWallet, _canPullETH, _getVaultAddress, _getOwner, _getDeposit, _isValidSignature, _registry, _eSIMWalletFactory, _entryPoint, _verifier, } from "../../logic/admin/reads/deviceWallet.reads.js";
+import { _deviceUniqueIdentifier, _isValidESIMWallet, _canPullFunds, _getVaultAddress, _getOwner, _getDeposit, _isValidSignature, _registry, _eSIMWalletFactory, _entryPoint, _verifier, } from "../../logic/admin/reads/deviceWallet.reads.js";
 /**
  * Thin EOA wrapper around a specific `DeviceWallet` instance. The instance
  * address is bound at construction; `KokioAdmin.setDeviceWalletAddress` swaps it
@@ -25,8 +25,8 @@ export class AdminDeviceWalletSubPackage {
     isValidESIMWallet(eSIMWallet) {
         return _isValidESIMWallet(this.walletClient, this.deviceWalletAddress, eSIMWallet);
     }
-    canPullETH(eSIMWallet) {
-        return _canPullETH(this.walletClient, this.deviceWalletAddress, eSIMWallet);
+    canPullFunds(eSIMWallet) {
+        return _canPullFunds(this.walletClient, this.deviceWalletAddress, eSIMWallet);
     }
     getVaultAddress() {
         return _getVaultAddress(this.walletClient, this.deviceWalletAddress);

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

@@ -1,5 +1,5 @@
-import { _buyDataBundle } from "../../logic/admin/eSIMWallet.eoa.js";
-import { _eSIMWalletFactory, _eSIMUniqueIdentifier, _newRequestedOwner, _owner, _dataBundlePriceCap, _deviceWallet, _transactionHistory, } from "../../logic/admin/reads/eSIMWallet.reads.js";
+import { _buyDataBundleWithToken } from "../../logic/admin/eSIMWallet.eoa.js";
+import { _eSIMWalletFactory, _eSIMUniqueIdentifier, _newRequestedOwner, _owner, _priceCapUSDCents, _deviceWallet, _transactionHistory, } from "../../logic/admin/reads/eSIMWallet.reads.js";
 /**
  * Thin EOA wrapper around a specific `ESIMWallet` instance. The instance address
  * is bound at construction; `KokioAdmin.setESIMWalletAddress` swaps it by
@@ -12,8 +12,8 @@ export class AdminESIMWalletSubPackage {
         this.walletClient = walletClient;
         this.eSIMWalletAddress = eSIMWalletAddress;
     }
-    buyDataBundle(dataBundleDetails, value = 0n) {
-        return _buyDataBundle(this.walletClient, this.eSIMWalletAddress, dataBundleDetails, value);
+    buyDataBundleWithToken(dataBundleDetails, asset, maxAmountIn, paymentReference) {
+        return _buyDataBundleWithToken(this.walletClient, this.eSIMWalletAddress, dataBundleDetails, asset, maxAmountIn, paymentReference);
     }
     // Reads: public storage getters and views
     eSIMWalletFactory() {
@@ -28,8 +28,8 @@ export class AdminESIMWalletSubPackage {
     owner() {
         return _owner(this.walletClient, this.eSIMWalletAddress);
     }
-    dataBundlePriceCap() {
-        return _dataBundlePriceCap(this.walletClient, this.eSIMWalletAddress);
+    priceCapUSDCents() {
+        return _priceCapUSDCents(this.walletClient, this.eSIMWalletAddress);
     }
     deviceWallet() {
         return _deviceWallet(this.walletClient, this.eSIMWalletAddress);

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

@@ -1,5 +1,5 @@
 import { _batchPopulateHistory, _deployLazyWalletAllBatches, _deployLazyWalletAndSetESIMIdentifier, _deployMoreESIMWalletsForLazyDevice, _setHistoryForLazyWallet, _setHistoryForLazyWalletAllBatches, _switchESIMIdentifierToNewDeviceIdentifier, _acceptOwnership, _transferOwnershipCall, _upgradeCall, } from "../../logic/admin/lazyWalletRegistry.eoa.js";
-import { _upgradeManager, _eSIMIdentifierToDeviceIdentifier, _deviceIdentifierToESIMDetails, _eSIMIdentifiersAssociatedWithDeviceIdentifier, _eSIMWalletsDeployed, _historyEntriesCopied, _isDeviceIdentifierReserved, _isESIMIdentifierReserved, _lazyDeployedESIMWallet, _lazyDeploymentSalt, _maxESIMWalletsPerCall, _maxHistoryEntriesPerCall, _owner, _pendingOwner, _proxiableUUID, _upgradeInterfaceVersion, } from "../../logic/admin/reads/lazyWalletRegistry.reads.js";
+import { _upgradeManager, _eSIMIdentifierToDeviceIdentifier, _deviceIdentifierToESIMDetails, _eSIMIdentifiersAssociatedWithDeviceIdentifier, _eSIMWalletsDeployed, _historyEntriesCopied, _outstandingHistoryEntries, _isDeviceIdentifierReserved, _isESIMIdentifierReserved, _lazyDeployedESIMWallet, _lazyDeploymentSalt, _maxESIMWalletsPerCall, _maxHistoryEntriesPerCall, _owner, _pendingOwner, _proxiableUUID, _upgradeInterfaceVersion, } from "../../logic/admin/reads/lazyWalletRegistry.reads.js";
 /** Thin EOA (eSIMWalletAdmin) wrapper around `LazyWalletRegistry`. */
 export class AdminLazyWalletRegistrySubPackage {
     walletClient;
@@ -70,6 +70,9 @@ export class AdminLazyWalletRegistrySubPackage {
         return _lazyDeployedESIMWallet(this.walletClient, eSIMIdentifier);
     }
     /** History cursor, per eSIM. */
+    outstandingHistoryEntries(eSIMIdentifier) {
+        return _outstandingHistoryEntries(this.walletClient, eSIMIdentifier);
+    }
     historyEntriesCopied(eSIMIdentifier) {
         return _historyEntriesCopied(this.walletClient, eSIMIdentifier);
     }