@aastar/sdk 0.20.8 → 0.21.0

package/dist/BaseClient-CkBhQ1ou.d.cts

@@ -0,0 +1,88 @@
+import { Address, Account } from 'viem';
+import { W as WalletClient, P as PublicClient } from './doc-types-471vSmPO.cjs';
+
+/**
+ * Base configuration for all L2 Business Clients
+ */
+interface ClientConfig {
+    /**
+     * Viem WalletClient for write operations.
+     * Must have an account attached.
+     */
+    client: WalletClient;
+    /**
+     * Optional PublicClient for read operations.
+     * If not provided, one will be derived from the WalletClient or created internally if possible (but usually explicit is better).
+     * Currently L1 actions use PublicClient | WalletClient, so WalletClient is enough for both if it has a provider.
+     * However, explicitly accepting PublicClient encourages separation.
+     */
+    publicClient?: PublicClient;
+    /**
+     * Registry contract address.
+     * Essential for looking up other contracts if not provided explicitly.
+     */
+    registryAddress?: Address;
+    /**
+     * GToken contract address.
+     * Required for operations involving token approvals and transfers.
+     */
+    gTokenAddress?: Address;
+    /**
+     * GTokenStaking contract address.
+     * Required for role registration that involves staking.
+     */
+    gTokenStakingAddress?: Address;
+    /**
+     * PaymasterFactory contract address.
+     * Required for deploying new PaymasterV4 instances.
+     */
+    paymasterFactoryAddress?: Address;
+    xpntsFactoryAddress?: Address;
+    ethUsdPriceFeedAddress?: Address;
+    entryPointAddress?: Address;
+}
+/**
+ * Common options for transaction methods
+ */
+interface TransactionOptions {
+    /**
+     * Override the account to use for the transaction.
+     * If not provided, uses the account from the WalletClient.
+     */
+    account?: Account | Address;
+    /**
+     * Optional value to send with the transaction (in wei)
+     */
+    value?: bigint;
+}
+/**
+ * Generic result wrapper for business operations
+ * Currently just returns the type directly, but can be expanded for metadata.
+ */
+type BusinessResult<T> = Promise<T>;
+
+declare abstract class BaseClient {
+    client: WalletClient;
+    publicClient?: PublicClient;
+    protected registryAddress?: Address;
+    protected gTokenAddress?: Address;
+    protected gTokenStakingAddress?: Address;
+    protected paymasterFactoryAddress?: Address;
+    protected entryPointAddress?: Address;
+    constructor(config: ClientConfig);
+    /**
+     * Get the account address of the connected wallet
+     */
+    getAddress(): Address;
+    /**
+     * Helper to ensure public client exists or fallback to wallet client (if it supports read)
+     */
+    getStartPublicClient(): PublicClient | WalletClient;
+    protected requireRegistry(): Address;
+    protected requireGToken(): Address;
+    protected requireGTokenStaking(): Address;
+    protected requirePaymasterFactory(): Address;
+    protected requireEntryPoint(): Address;
+}
+
+export { type BusinessResult as B, type ClientConfig as C, type TransactionOptions as T, BaseClient as a };

package/dist/UserClient-BDGP37PK.js

@@ -0,0 +1,6 @@
+export { UserClient } from './chunk-MCALA6WM.js';
+import './chunk-M5WFKETT.js';
+import './chunk-UCLK6LTB.js';
+import './chunk-PZ5AY32C.js';
+//# sourceMappingURL=UserClient-BDGP37PK.js.map
+//# sourceMappingURL=UserClient-BDGP37PK.js.map

package/dist/{UserClient-AIIHB54I.js.map → UserClient-BDGP37PK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"UserClient-AIIHB54I.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"UserClient-BDGP37PK.js"}

package/dist/UserClient-FOAOBLGK.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkDEUBKZH5_cjs = require('./chunk-DEUBKZH5.cjs');
+require('./chunk-CIEYY3A6.cjs');
+require('./chunk-MXJEULSE.cjs');
+require('./chunk-Q7SFCCGT.cjs');
+
+
+
+Object.defineProperty(exports, "UserClient", {
+  enumerable: true,
+  get: function () { return chunkDEUBKZH5_cjs.UserClient; }
+});
+//# sourceMappingURL=UserClient-FOAOBLGK.cjs.map
+//# sourceMappingURL=UserClient-FOAOBLGK.cjs.map

package/dist/UserClient-FOAOBLGK.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"UserClient-FOAOBLGK.cjs"}

package/dist/account.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+var chunkM7HXR7G5_cjs = require('./chunk-M7HXR7G5.cjs');
+require('./chunk-CIEYY3A6.cjs');
+require('./chunk-MXJEULSE.cjs');
+require('./chunk-Q7SFCCGT.cjs');
+
+
+
+Object.defineProperty(exports, "UserOpClient", {
+  enumerable: true,
+  get: function () { return chunkM7HXR7G5_cjs.UserOpClient; }
+});
+Object.defineProperty(exports, "createEOAWalletClient", {
+  enumerable: true,
+  get: function () { return chunkM7HXR7G5_cjs.createEOAWalletClient; }
+});
+Object.defineProperty(exports, "getUserOpHash", {
+  enumerable: true,
+  get: function () { return chunkM7HXR7G5_cjs.getUserOpHash; }
+});
+Object.defineProperty(exports, "packUserOpLimits", {
+  enumerable: true,
+  get: function () { return chunkM7HXR7G5_cjs.packUserOpLimits; }
+});
+Object.defineProperty(exports, "toSimpleSmartAccount", {
+  enumerable: true,
+  get: function () { return chunkM7HXR7G5_cjs.toSimpleSmartAccount; }
+});
+//# sourceMappingURL=account.cjs.map
+//# sourceMappingURL=account.cjs.map

package/dist/account.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"account.cjs"}

package/dist/account.d.cts

@@ -0,0 +1,48 @@
+import { WalletClient, Address, Hex, Hash, Chain, Transport, LocalAccount } from 'viem';
+
+type EOAWalletClient = WalletClient & {
+    sendTransaction: (args: {
+        to: Address;
+        value?: bigint;
+        data?: Hex;
+    }) => Promise<Hash>;
+    getAddress: () => Address;
+};
+declare const createEOAWalletClient: (privateKey: Hex, chain: Chain, transport?: Transport) => EOAWalletClient;
+
+type SimpleSmartAccount = LocalAccount & {
+    signUserOperation: (userOp: any) => Promise<Hex>;
+    getInitCode: () => Promise<Hex>;
+    getDummySignature: () => Promise<Hex>;
+    entryPoint: Address;
+};
+declare function toSimpleSmartAccount(parameters: {
+    client: any;
+    owner: LocalAccount;
+    factoryAddress: Address;
+    entryPoint: {
+        address: Address;
+        version: '0.6' | '0.7';
+    };
+    salt?: bigint;
+    index?: bigint;
+}): Promise<SimpleSmartAccount>;
+
+/**
+ * Common Pack Logic for v0.7 UserOperations
+ */
+declare function packUserOpLimits(high: bigint, low: bigint): Hex;
+/**
+ * Local implementation of EntryPoint v0.7 getUserOpHash
+ */
+declare function getUserOpHash(op: any, ep: Address, chainId: number): Hex;
+/**
+ * UserOperation Client for handling high-level flows
+ */
+declare class UserOpClient {
+    static estimateGas(bundler: any, op: any, entryPoint: Address): Promise<any>;
+    static sendUserOp(bundler: any, op: any, entryPoint: Address): Promise<any>;
+    static getReceipt(bundler: any, hash: Hex): Promise<any>;
+}
+
+export { type EOAWalletClient, type SimpleSmartAccount, UserOpClient, createEOAWalletClient, getUserOpHash, packUserOpLimits, toSimpleSmartAccount };

package/dist/account.js

@@ -1,6 +1,6 @@
-export { UserOpClient, createEOAWalletClient, getUserOpHash, packUserOpLimits, toSimpleSmartAccount } from './chunk-4EZD7LPE.js';
-import './chunk-6QYXGMCR.js';
-import './chunk-G3UJC4EL.js';
+export { UserOpClient, createEOAWalletClient, getUserOpHash, packUserOpLimits, toSimpleSmartAccount } from './chunk-E4CQFW75.js';
+import './chunk-M5WFKETT.js';
+import './chunk-UCLK6LTB.js';
 import './chunk-PZ5AY32C.js';
 //# sourceMappingURL=account.js.map
 //# sourceMappingURL=account.js.map

package/dist/admin.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkZ4GZ6DQA_cjs = require('./chunk-Z4GZ6DQA.cjs');
+require('./chunk-CIEYY3A6.cjs');
+require('./chunk-MXJEULSE.cjs');
+require('./chunk-Q7SFCCGT.cjs');
+
+
+
+Object.defineProperty(exports, "ProtocolGovernance", {
+  enumerable: true,
+  get: function () { return chunkZ4GZ6DQA_cjs.ProtocolGovernance; }
+});
+//# sourceMappingURL=admin.cjs.map
+//# sourceMappingURL=admin.cjs.map

package/dist/admin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"admin.cjs"}

package/dist/admin.d.cts

@@ -0,0 +1,62 @@
+import { Address, Hash, Hex } from 'viem';
+import { a as BaseClient, C as ClientConfig, T as TransactionOptions } from './BaseClient-CkBhQ1ou.cjs';
+import './doc-types-471vSmPO.cjs';
+
+interface ProtocolParams {
+    minStake: bigint;
+    treasury: Address;
+    entryPoint: Address;
+    superPaymaster: Address;
+}
+/**
+ * ProtocolGovernance - L3 Pattern
+ *
+ * Responsibilities:
+ * 1. Global Protocol Parameter Management (Registry, EntryPoint)
+ * 2. High-level Governance Operations (DAO Transfer, Upgrades)
+ * 3. SuperPaymaster & Module Approval
+ */
+declare class ProtocolGovernance extends BaseClient {
+    registryAddress: Address;
+    entryPointAddress: Address;
+    constructor(config: ClientConfig & {
+        registryAddress: Address;
+        entryPointAddress: Address;
+    });
+    /**
+     * Update the Global Treasury Address where protocol fees are collected
+     */
+    setTreasury(treasury: Address, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Update the supported EntryPoint address
+     */
+    updateEntryPoint(entryPoint: Address, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Approve a new SuperPaymaster contract address
+     */
+    setSuperPaymaster(paymaster: Address, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Set the Staking contract address
+     */
+    setStaking(staking: Address, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Configure a Role's parameters (Admin only).
+     * Reads the current on-chain config first, then merges the provided overrides
+     * and writes back the full struct via configureRole.
+     */
+    configureRole(params: {
+        roleId: Hex;
+        minStake?: bigint;
+        ticketPrice?: bigint;
+        exitFeePercent?: bigint;
+        minExitFee?: bigint;
+    }, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Transfer Protocol Ownership to a DAO (Multisig/Timelock)
+     * This is the final step of "Protocol Admin" lifecycle.
+     */
+    transferToDAO(daoAddress: Address, options?: TransactionOptions): Promise<Hash>;
+    getProtocolParams(): Promise<ProtocolParams>;
+}
+
+export { ProtocolGovernance, type ProtocolParams };

package/dist/admin.js

@@ -1,6 +1,6 @@
-export { ProtocolGovernance } from './chunk-FJ7XECC5.js';
-import './chunk-6QYXGMCR.js';
-import './chunk-G3UJC4EL.js';
+export { ProtocolGovernance } from './chunk-EY2AJTGV.js';
+import './chunk-M5WFKETT.js';
+import './chunk-UCLK6LTB.js';
 import './chunk-PZ5AY32C.js';
 //# sourceMappingURL=admin.js.map
 //# sourceMappingURL=admin.js.map