@sodax/wallet-sdk-react 2.0.0-rc.1 → 2.0.0-rc.11

package/dist/xchains/sui/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/core/XService.ts","../../../src/utils/index.ts","../../../src/shared/guards.ts","../../../src/xchains/sui/SuiXService.ts","../../../src/core/XConnector.ts","../../../src/xchains/sui/SuiXConnector.ts"],"names":["address","SuiWalletProvider"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ChainType, IXServiceBase, XToken } from '@sodax/types';\nimport type { IXConnector } from '@/types/interfaces.js';\n\n/**\n * Abstract base class for blockchain service implementations.\n *\n * The XService class serves as a foundation for implementing blockchain-specific services\n * in a multi-chain environment. It provides a standardized interface for:\n * 1. Managing wallet connectors for different blockchain types\n * 2. Querying token balances across different chains\n *\n * Each blockchain implementation (e.g., Solana, EVM chains) extends this class\n * to provide chain-specific functionality while maintaining a consistent interface.\n *\n * @abstract\n * @class XService\n * @property {ChainType} xChainType - The blockchain type this service handles (e.g., 'SOLANA', 'EVM')\n * @property {XConnector[]} xConnectors - Available wallet connectors for this chain\n *\n */\nexport abstract class XService implements IXServiceBase {\n  /** The blockchain type this service handles */\n  public readonly xChainType: ChainType;\n\n  /** Available wallet connectors for this chain */\n  private xConnectors: IXConnector[] = [];\n\n  constructor(xChainType: ChainType) {\n    this.xChainType = xChainType;\n  }\n\n  /**\n   * Gets the balance of a specific token for an address\n   * @param address The wallet address to check\n   * @param xToken The token to get the balance for\n   * @returns Promise resolving to the token balance as a bigint\n   */\n  public async getBalance(address: string | undefined, xToken: XToken): Promise<bigint> {\n    return 0n;\n  }\n\n  /**\n   * Gets balances for multiple tokens for an address\n   * @param address The wallet address to check\n   * @param xTokens Array of tokens to get balances for\n   * @returns Promise resolving to object mapping token addresses to balances\n   */\n  public async getBalances(address: string | undefined, xTokens: readonly XToken[]): Promise<Record<string, bigint>> {\n    if (!address) return {};\n\n    const balancePromises = xTokens.map(async xToken => {\n      const balance = await this.getBalance(address, xToken);\n      return { address: xToken.address, balance };\n    });\n\n    const balances = await Promise.all(balancePromises);\n    return balances.reduce<Record<string, bigint>>((acc, { address, balance }) => {\n      acc[address] = balance;\n      return acc;\n    }, {});\n  }\n\n  /**\n   * Gets all available connectors for this chain\n   */\n  public getXConnectors(): IXConnector[] {\n    return this.xConnectors;\n  }\n\n  /**\n   * Sets the available connectors for this chain\n   */\n  public setXConnectors(xConnectors: IXConnector[]): void {\n    this.xConnectors = xConnectors;\n  }\n\n  /**\n   * Gets a specific connector by its ID\n   * @param xConnectorId The connector ID to look up\n   * @returns The matching connector or undefined if not found\n   */\n  public getXConnectorById(xConnectorId: string): IXConnector | undefined {\n    return this.getXConnectors().find(xConnector => xConnector.id === xConnectorId);\n  }\n}\n","import { baseChainInfo, type SpokeChainKey, type XToken } from '@sodax/types';\n\nexport { sortConnectors, type SortConnectorsOptions } from './sortConnectors.js';\nexport {\n  getEntryDefaults,\n  getRpcUrl,\n  resolveEvmDefaults,\n  type WalletDefaultsByKey,\n} from './walletRpcConfig.js';\n\nexport const isNativeToken = (xToken: XToken): boolean => {\n  const nativeAddresses = [\n    'cx0000000000000000000000000000000000000000',\n    '0x0000000000000000000000000000000000000000',\n    'inj',\n    '0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI',\n    'hx0000000000000000000000000000000000000000',\n    '11111111111111111111111111111111', // solana\n    'CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA', // stellar\n    'ST000000000000000000002AMW42H.nativetoken', // stacks\n    '0:0', // bitcoin\n  ];\n\n  return nativeAddresses.includes(xToken.address);\n};\n\nexport const getWagmiChainId = (xChainId: SpokeChainKey): number => {\n  const chainId = baseChainInfo[xChainId].chainId;\n  if (typeof chainId !== 'number') {\n    throw new Error(`[wallet-sdk-react] getWagmiChainId: expected numeric chainId, got ${typeof chainId}`);\n  }\n  return chainId;\n};\n","// packages/wallet-sdk-react/src/shared/guards.ts\n\n/**\n * Tiny runtime type guards used to safely narrow `unknown` values.\n *\n * Why this exists:\n * - In wallets land, many values come from outside TypeScript (window injections, 3rd-party SDKs, serialized state).\n * - Writing `as SomeType` skips checks and can crash later in confusing places.\n * - Guards + `assert(...)` let us fail fast with a clear error message at the boundary.\n */\n\nexport type UnknownRecord = Record<string, unknown>;\n\n/** True if value is a non-null object (Record-like). */\nexport function isRecord(value: unknown): value is UnknownRecord {\n  return typeof value === 'object' && value !== null;\n}\n\n/** True if the object has a string property at `key`. */\nexport function hasStringProperty<Key extends string>(\n  value: unknown,\n  key: Key,\n): value is UnknownRecord & Record<Key, string> {\n  return isRecord(value) && typeof value[key] === 'string';\n}\n\n/** True if the object has an optional string property at `key`. */\nexport function hasOptionalStringProperty<Key extends string>(\n  value: unknown,\n  key: Key,\n): value is UnknownRecord & Partial<Record<Key, string>> {\n  return isRecord(value) && (value[key] === undefined || typeof value[key] === 'string');\n}\n\n/** True if the object has a boolean property at `key`. */\nexport function hasBooleanProperty<Key extends string>(\n  value: unknown,\n  key: Key,\n): value is UnknownRecord & Record<Key, boolean> {\n  return isRecord(value) && typeof value[key] === 'boolean';\n}\n\n/** True if the object has a function property at `key`. */\nexport function hasFunctionProperty<Key extends string>(\n  value: unknown,\n  key: Key,\n): value is UnknownRecord & Record<Key, (...args: unknown[]) => unknown> {\n  return isRecord(value) && typeof value[key] === 'function';\n}\n\n/**\n * Throws if condition is false.\n * Use this after guards to stop execution early with an actionable error message.\n */\nexport function assert(condition: unknown, message: string): asserts condition {\n  if (!condition) {\n    throw new Error(message);\n  }\n}\n\n/**\n * Validates the runtime shape of Sui provider dependencies before passing them to wallet-sdk-core.\n * Used by both SuiHydrator (render path) and SuiXService.createWalletProvider (imperative path).\n */\nexport function assertSuiProviderShape(caller: string, client: unknown, wallet: unknown, account: unknown): void {\n  const clientOk =\n    isRecord(client) &&\n    hasFunctionProperty(client, 'executeTransactionBlock') &&\n    hasFunctionProperty(client, 'devInspectTransactionBlock') &&\n    hasFunctionProperty(client, 'getCoins');\n  assert(clientOk, `[${caller}] invalid Sui client shape`);\n\n  const walletOk = isRecord(wallet) && hasStringProperty(wallet, 'name');\n  assert(walletOk, `[${caller}] invalid Sui wallet shape`);\n\n  const accountOk = isRecord(account) && hasStringProperty(account, 'address');\n  assert(accountOk, `[${caller}] invalid Sui account shape`);\n}\n","import { XService } from '@/core/XService.js';\nimport type { XToken, ISuiWalletProvider } from '@sodax/types';\nimport { SuiWalletProvider } from '@sodax/wallet-sdk-core';\nimport { isNativeToken } from '@/utils/index.js';\nimport { assertSuiProviderShape } from '@/shared/guards.js';\n\n// These fields are hydrated by SuiHydrator from @mysten/dapp-kit hooks.\n// We use structural interfaces instead of importing nominal types from @mysten/wallet-standard\n// because dapp-kit may resolve a different version than wallet-sdk-core, causing nominal mismatch.\n// The `getBalance` method is the only field we call directly — the rest are passed through.\ninterface SuiClientLike {\n  getBalance(input: { owner: string; coinType: string }): Promise<{ totalBalance: string }>;\n}\n\nexport class SuiXService extends XService {\n  private static instance: SuiXService;\n\n  // Hydrated by SuiHydrator. Start undefined because wallet may not be connected yet.\n  // suiClient is typed structurally for the methods we call directly.\n  // suiWallet/suiAccount are opaque — stored and passed through to SuiWalletProvider.\n  public suiClient: SuiClientLike | undefined;\n  public suiWallet: unknown;\n  public suiAccount: unknown;\n\n  private constructor() {\n    super('SUI');\n  }\n\n  public static getInstance(): SuiXService {\n    if (!SuiXService.instance) {\n      SuiXService.instance = new SuiXService();\n    }\n    return SuiXService.instance;\n  }\n\n  createWalletProvider(): ISuiWalletProvider | undefined {\n    if (!this.suiClient || !this.suiWallet || !this.suiAccount) {\n      console.warn(\n        '[SuiXService] createWalletProvider: missing dependencies — wallet not connected yet',\n        { hasClient: !!this.suiClient, hasWallet: !!this.suiWallet, hasAccount: !!this.suiAccount },\n      );\n      return undefined;\n    }\n\n    // Runtime validation before passing data to wallet-sdk-core. This avoids \"trust me bro\" casting.\n    // Note: we validate the minimum shape we rely on; the exact nominal types may differ by package version.\n    assertSuiProviderShape('SuiXService', this.suiClient, this.suiWallet, this.suiAccount);\n\n    // Version mismatch cast: dapp-kit hooks return types from their bundled @mysten/wallet-standard,\n    // which differs nominally from wallet-sdk-core's version. Structurally identical at runtime.\n    type SuiWalletProviderConfig = ConstructorParameters<typeof SuiWalletProvider>[0];\n    return new SuiWalletProvider({\n      client: this.suiClient,\n      wallet: this.suiWallet,\n      account: this.suiAccount,\n    } as unknown as SuiWalletProviderConfig);\n  }\n\n  // getBalance is not used because getBalances uses getAllBalances which returns all balances\n\n  override async getBalances(address: string | undefined, xTokens: readonly XToken[]): Promise<Record<string, bigint>> {\n    if (!address || !this.suiClient) return {};\n    // Capture in local so the closure sees a narrowed (non-undefined) reference.\n    const client = this.suiClient;\n    try {\n      const balancePromises = xTokens.map(async xToken => {\n        let coinType = isNativeToken(xToken) ? '0x2::sui::SUI' : xToken.address;\n\n        //  TODO: hard coded for getting legacy bnUSD balance\n        if (\n          coinType ===\n          '0x03917a812fe4a6d6bc779c5ab53f8a80ba741f8af04121193fc44e0f662e2ceb::balanced_dollar::BALANCED_DOLLAR'\n        ) {\n          coinType =\n            '0x3917a812fe4a6d6bc779c5ab53f8a80ba741f8af04121193fc44e0f662e2ceb::balanced_dollar::BALANCED_DOLLAR';\n        }\n\n        const balance = await client.getBalance({\n          owner: address,\n          coinType: coinType,\n        });\n\n        return {\n          address: xToken.address,\n          balance: balance ? BigInt(balance.totalBalance) : undefined,\n        };\n      });\n\n      const results = await Promise.all(balancePromises);\n\n      const tokenMap: Record<string, bigint> = {};\n      results.forEach(result => {\n        if (result.balance !== undefined) {\n          tokenMap[result.address] = result.balance;\n        }\n      });\n\n      return tokenMap;\n    } catch (error) {\n      console.error('[wallet-sdk-react] SUI getBalances failed:', error);\n      return {};\n    }\n  }\n}\n","import type { ChainType } from '@sodax/types';\nimport type { XAccount } from '@/types/index.js';\nimport type { IXConnector } from '@/types/interfaces.js';\n\n/**\n * Base class for wallet provider connectors that handles connection management and wallet interactions\n *\n * @abstract\n * @class XConnector\n * @property {ChainType} xChainType - The blockchain type this connector supports\n * @property {string} name - Display name of the wallet provider\n * @property {string} _id - Unique identifier for the connector\n * @property {string | undefined} _icon - Optional icon URL for the wallet provider\n */\n\nexport abstract class XConnector implements IXConnector {\n  /** The blockchain type this connector supports */\n  public readonly xChainType: ChainType;\n\n  /** Display name of the wallet provider */\n  public readonly name: string;\n\n  /** Unique identifier for the connector */\n  public readonly _id: string;\n\n  /** Optional icon URL for the wallet provider */\n  public readonly _icon?: string;\n\n  constructor(xChainType: ChainType, name: string, id: string) {\n    this.xChainType = xChainType;\n    this.name = name;\n    this._id = id;\n  }\n\n  /**\n   * Connects to the wallet provider\n   * @returns Promise resolving to the connected account, or undefined if connection fails\n   */\n  abstract connect(): Promise<XAccount | undefined>;\n\n  /**\n   * Disconnects from the wallet provider\n   */\n  abstract disconnect(): Promise<void>;\n\n  /** Get the unique identifier for this connector */\n  public get id(): string {\n    return this._id;\n  }\n\n  /** Get the optional icon URL for this wallet provider */\n  public get icon(): string | undefined {\n    return this._icon;\n  }\n\n  /**\n   * True when the wallet extension backing this connector is installed.\n   * Default: true (for provider-managed chains where connector presence already\n   * implies install — EVM via EIP-6963, Solana/Sui via adapter discovery).\n   * Subclasses backed by extension injection (Bitcoin, ICON, Stacks) override\n   * this with a window probe.\n   */\n  public get isInstalled(): boolean {\n    return true;\n  }\n\n  /** URL to install the wallet extension when missing. Subclasses override. */\n  public get installUrl(): string | undefined {\n    return undefined;\n  }\n}\n","import type { XAccount } from '@/types/index.js';\n\nimport { XConnector } from '@/core/index.js';\nimport { SuiXService } from './SuiXService.js';\nimport { assert, hasOptionalStringProperty, hasStringProperty, isRecord } from '@/shared/guards.js';\n\n// Structural interface for what we actually use from a Sui wallet.\n// We don't import the nominal type from @mysten/wallet-standard because\n// @mysten/dapp-kit may resolve a different version, causing nominal mismatch.\n// Structural typing avoids this: as long as the object has these fields, it works.\ninterface SuiWalletInfo {\n  id?: string;\n  name: string;\n  icon?: string;\n}\n\nconst isSuiWalletInfo = (value: unknown): value is SuiWalletInfo => {\n  return (\n    isRecord(value) &&\n    hasStringProperty(value, 'name') &&\n    // Some wallets may not expose `id` — in that case we fall back to `name` for stability.\n    // We still validate if it exists.\n    hasOptionalStringProperty(value, 'id') &&\n    hasOptionalStringProperty(value, 'icon')\n  );\n};\n\nexport class SuiXConnector extends XConnector {\n  public readonly wallet: SuiWalletInfo;\n\n  constructor(wallet: unknown) {\n    assert(isSuiWalletInfo(wallet), '[SuiXConnector] invalid wallet object');\n\n    const id = wallet.id ?? wallet.name;\n    // After the fallback, `id` is always defined.\n    assert(typeof id === 'string' && id.length > 0, '[SuiXConnector] invalid wallet id');\n\n    super('SUI', wallet.name, id);\n    this.wallet = { id, name: wallet.name, icon: wallet.icon };\n  }\n\n  getXService(): SuiXService {\n    return SuiXService.getInstance();\n  }\n\n  async connect(): Promise<XAccount | undefined> {\n    return;\n  }\n\n  async disconnect(): Promise<void> {}\n\n  public override get icon(): string | undefined {\n    return this.wallet.icon;\n  }\n}\n"]}

package/dist/xchains/sui/index.mjs.map

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

package/docs/ADDING_A_NEW_CHAIN.md

@@ -1,440 +0,0 @@
-# Adding a New Chain
-
-This document is the contributor workflow for onboarding a new chain family (e.g. Aptos, Cosmos, …) into `@sodax/wallet-sdk-react`. Most steps are mechanical because the central abstractions (`ChainMeta`, `chainRegistry`, sub-path exports) auto-derive downstream types — adding a chain is mostly **filling in entries**, not rewriting hooks.
-
-Prerequisite: read [`ARCHITECTURE.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/ARCHITECTURE.md) first, especially the [Provider-managed vs non-provider](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/ARCHITECTURE.md#provider-managed-vs-non-provider-chains) split — that decision drives the rest of this guide.
-
-## Table of contents
-
-1. [Decision tree — provider-managed or not?](#decision-tree--provider-managed-or-not)
-2. [Step 1 — types in `@sodax/types`](#step-1--types-in-sodaxtypes)
-3. [Step 2 — wallet provider in `@sodax/wallet-sdk-core`](#step-2--wallet-provider-in-sodaxwallet-sdk-core)
-4. [Step 3 — `XService` + `XConnector` in `xchains/<chain>/`](#step-3--xservice--xconnector-in-xchainschain)
-5. [Step 4 — `xchains/<chain>/index.ts` barrel for sub-path export](#step-4--xchainschainindexts-barrel-for-sub-path-export)
-6. [Step 5 — `ChainMeta` entry in `types/config.ts`](#step-5--chainmeta-entry-in-typesconfigts)
-7. [Step 6 — register in `chainRegistry`](#step-6--register-in-chainregistry)
-8. [Step 7 — provider-managed only — Provider/Hydrator/Actions trio](#step-7--provider-managed-only--providerhydratoractions-trio)
-9. [Step 8 — barrel surface (`src/index.ts`)](#step-8--barrel-surface-srcindexts)
-10. [Step 9 — tests](#step-9--tests)
-11. [Verification checklist](#verification-checklist)
-
----
-
-## Decision tree — provider-managed or not?
-
-Set `providerManaged: true` if **any** of these is true:
-
-- The chain ships a React adapter library (wagmi, `@solana/wallet-adapter-react`, `@mysten/dapp-kit`, etc.) that you want to use.
-- The wallet-side SDK requires a long-lived React context to register handlers and survive component re-renders.
-- Wallet discovery is reactive (EIP-6963 announcements, dynamic adapter registration) and you want components to re-render automatically.
-
-Set `providerManaged: false` if:
-
-- You can probe `window.<wallet>` synchronously per-call.
-- Connection lifecycle is short-lived (call `connect()`, get an account back, no React context needed).
-- The native SDK is plain TS classes/functions with no React glue (e.g. `sats-connect`, `icon-sdk-js`).
-
-**Mixing** — you can have a non-provider chain whose `discoverConnectors` is async (Stellar). That's still `providerManaged: false` because the connectors are static after discovery; the React adapter pattern isn't used.
-
----
-
-## Step 1 — types in `@sodax/types`
-
-Add the chain's identity and types to `packages/types/src/`:
-
-1. **Chain key** in [`packages/types/src/chains/chain-keys.ts`](https://github.com/icon-project/sodax-sdks/blob/main/packages/types/src/chains/chain-keys.ts):
-   ```typescript
-   export const ChainKeys = {
-     ...
-     APTOS_MAINNET: 'aptos',
-   };
-   ```
-2. **Chain type** in `ChainTypeArr`:
-   ```typescript
-   export const ChainTypeArr = [..., 'APTOS'] as const;
-   ```
-3. **Chain key type alias**:
-   ```typescript
-   export type AptosChainKey = typeof ChainKeys.APTOS_MAINNET;
-   ```
-4. **Chain info entry** in [`packages/types/src/chains/chains.ts`](https://github.com/icon-project/sodax-sdks/blob/main/packages/types/src/chains/chains.ts) (`baseChainInfo`):
-   ```typescript
-   [ChainKeys.APTOS_MAINNET]: { type: 'APTOS', chainId: '0x1' /* or numeric */, displayName: 'Aptos' }
-   ```
-5. **Wallet provider interface** in `packages/types/src/aptos.ts`:
-   ```typescript
-   export interface IAptosWalletProvider extends WalletAddressProvider {
-     readonly chainType: 'APTOS';
-     // chain-specific methods: signAndSubmitTransaction, signMessage, ...
-   }
-   ```
-6. **Add to root barrel** if you want it re-exported from `@sodax/types`, or leave as a sub-package export per [`packages/types/CLAUDE.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/types/CLAUDE.md).
-
-The `ChainKey` and `ChainType` unions auto-derive — once these entries land, downstream code in `@sodax/sdk` and `@sodax/wallet-sdk-react` sees the new chain at the type level.
-
----
-
-## Step 2 — wallet provider in `@sodax/wallet-sdk-core`
-
-Add `packages/wallet-sdk-core/src/wallet-providers/aptos/`:
-
-```
-aptos/
-├── AptosWalletProvider.ts
-├── AptosWalletProvider.test.ts
-├── types.ts                    # PrivateKey<chain>WalletConfig + BrowserExtension<chain>WalletConfig + AptosWalletDefaults
-└── index.ts                    # Barrel re-export
-```
-
-`AptosWalletProvider` extends `BaseWalletProvider<AptosWalletDefaults>` and implements `IAptosWalletProvider`. Discriminated config — pick a discriminant pattern:
-
-- **Field presence** (no `type` field): `privateKey` field present vs. absent. Most chains use this.
-- **Explicit `type`**: `'PRIVATE_KEY'` | `'BROWSER_EXTENSION'`. Use when both modes share fields that would clash without a discriminant (Bitcoin, Stellar).
-
-See [`packages/wallet-sdk-core/CLAUDE.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-core/CLAUDE.md#config-variants-discriminants) for the canonical patterns.
-
-Re-export from `packages/wallet-sdk-core/src/wallet-providers/index.ts`:
-
-```typescript
-export * from './aptos/index.js';
-```
-
----
-
-## Step 3 — `XService` + `XConnector` in `xchains/<chain>/`
-
-Create `packages/wallet-sdk-react/src/xchains/aptos/`:
-
-```
-aptos/
-├── AptosXService.ts
-├── AptosXConnector.ts
-├── AptosXConnector.test.ts
-└── index.ts
-```
-
-### `AptosXService`
-
-Singleton that owns the connector list and exposes balance reads. Extend the abstract `XService`:
-
-```typescript
-import type { XToken } from '@sodax/types';
-import { XService } from '@/core/index.js';
-
-export class AptosXService extends XService {
-  private static instance: AptosXService | undefined;
-
-  static getInstance(rpcConfig?: { rpcUrl?: string }): AptosXService {
-    if (!AptosXService.instance) AptosXService.instance = new AptosXService(rpcConfig);
-    return AptosXService.instance;
-  }
-
-  // chain-specific state (RPC client, etc.)
-
-  async getBalance(address: string, xToken: XToken): Promise<bigint> {
-    // …
-  }
-}
-```
-
-### `AptosXConnector`
-
-Extend `XConnector`. The base class provides `id`, `icon`, `isInstalled = true` defaults; override `isInstalled` / `installUrl` for browser-extension-backed connectors:
-
-```typescript
-import { XConnector } from '@/core/index.js';
-import type { XAccount } from '@/types/index.js';
-
-export class AptosWalletXConnector extends XConnector {
-  constructor() {
-    super('APTOS', 'Aptos Wallet', 'aptos.wallet');
-  }
-
-  override get isInstalled(): boolean {
-    return typeof window !== 'undefined' && 'aptos' in window;
-  }
-
-  override get installUrl(): string {
-    return 'https://chrome.google.com/webstore/detail/...';
-  }
-
-  async connect(): Promise<XAccount | undefined> {
-    const account = await window.aptos.connect();
-    return account ? { address: account.address, xChainType: 'APTOS', publicKey: account.publicKey } : undefined;
-  }
-
-  async disconnect(): Promise<void> {
-    await window.aptos.disconnect();
-  }
-}
-```
-
-For chains with multiple wallets (Bitcoin: Unisat / Xverse / OKX; Injective: MetaMask / Keplr / Leap), create one `XConnector` subclass per wallet and have an abstract intermediate base if shared logic exists (Bitcoin uses `BitcoinXConnector` abstract).
-
----
-
-## Step 4 — `xchains/<chain>/index.ts` barrel for sub-path export
-
-Create the barrel that powers `@sodax/wallet-sdk-react/xchains/aptos`:
-
-```typescript
-// src/xchains/aptos/index.ts
-export { AptosXService } from './AptosXService.js';
-export { AptosWalletXConnector } from './AptosXConnector.js';
-```
-
-`tsup.config.ts` already picks up `src/xchains/*/index.ts` via glob — **no config edit needed**. The sub-path export will resolve as `@sodax/wallet-sdk-react/xchains/aptos`.
-
-See [`SUB_PATH_EXPORTS.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/SUB_PATH_EXPORTS.md) for the export plumbing.
-
----
-
-## Step 5 — `ChainMeta` entry in `types/config.ts`
-
-[`ChainMeta`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/src/types/config.ts) is the **single source of truth** for per-chain-type metadata. `SodaxWalletConfig`, `ChainTypeConfig<T>`, `ChainEntry<K>`, `WalletDefaultsByKey<K>` all derive from it automatically.
-
-Add **one entry**:
-
-```typescript
-export type AptosChainEntry = SimpleChainEntry<AptosWalletDefaults>;
-
-export type ChainMeta = {
-  EVM: { ... };
-  // ...
-  APTOS: {
-    keys: AptosChainKey;          // from @sodax/types
-    entry: AptosChainEntry;       // { rpcUrl?, defaults? } (or richer if chain has multi-field RPC)
-    defaults: AptosWalletDefaults;
-    adapter: {};                  // {} for non-provider chains; AptosAdapterFields if provider-managed
-  };
-};
-```
-
-If the chain has multi-field RPC (Stellar's horizon + soroban, Bitcoin's RPC + Radfi), define a custom entry shape that extends `*RpcConfig` from `@sodax/types`:
-
-```typescript
-export type AptosChainEntry = AptosRpcConfig & { defaults?: AptosWalletDefaults };
-```
-
-If provider-managed, define `AptosAdapterFields` (one value per React provider — wagmi-config-level settings, not per-chain):
-
-```typescript
-export type AptosAdapterFields = {
-  network?: 'mainnet' | 'testnet' | 'devnet';
-  autoConnect?: boolean;
-};
-```
-
-Add the per-chain-type alias for external typing convenience:
-
-```typescript
-export type AptosTypeConfig = ChainTypeConfig<'APTOS'>;
-```
-
----
-
-## Step 6 — register in `chainRegistry`
-
-Add an entry to [`chainRegistry`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/src/chainRegistry.ts):
-
-### Non-provider chain
-
-```typescript
-APTOS: defineChain({
-  createService: walletConfig =>
-    AptosXService.getInstance({ rpcUrl: getRpcUrl(walletConfig?.APTOS?.chains?.[ChainKeys.APTOS_MAINNET]) }),
-  displayName: 'Aptos',
-  defaultConnectors: () => [new AptosWalletXConnector()],
-  providerManaged: false,
-  // Optional — provide createActions if signMessage needs custom dispatch (Bitcoin's BIP-322/ECDSA)
-  createActions: (service, getStore) => ({
-    ...createDefaultActions('APTOS', service, getStore),
-    signMessage: async (message: string) => {
-      // chain-specific signing logic
-    },
-  }),
-  // Optional — provide createWalletProvider if the chain needs a wallet provider in `walletProviders` map
-  createWalletProvider: (service, getStore) => {
-    const connection = getStore().xConnections.APTOS;
-    if (!connection?.xConnectorId) return undefined;
-    const defaults = getEntryDefaults<typeof ChainKeys.APTOS_MAINNET>(
-      getStore().walletConfig?.APTOS?.chains?.[ChainKeys.APTOS_MAINNET],
-    );
-    return new AptosWalletProvider({ /* ... */, defaults });
-  },
-  // Optional — provide discoverConnectors if connectors require async detection
-  discoverConnectors: async (service, getStore) => {
-    const wallets = await detectInstalledAptosWallets();
-    const connectors = wallets.map(w => new AptosWalletXConnector(w));
-    service.setXConnectors(connectors);
-    getStore().setXConnectors('APTOS', connectors);
-  },
-}),
-```
-
-### Provider-managed chain
-
-```typescript
-APTOS: defineChain({
-  createService: () => AptosXService.getInstance(),
-  displayName: 'Aptos',
-  defaultConnectors: () => [],   // ignored — connectors come from the React adapter
-  providerManaged: true,
-  // No createActions / createWalletProvider — the Hydrator handles both.
-}),
-```
-
----
-
-## Step 7 — provider-managed only — Provider/Hydrator/Actions trio
-
-Skip this step for `providerManaged: false`.
-
-Create `packages/wallet-sdk-react/src/providers/aptos/`:
-
-```
-aptos/
-├── AptosProvider.tsx          # Wraps native React adapter
-├── AptosHydrator.tsx          # Sole writer of connection state + walletProviders
-├── AptosActions.tsx           # Registers ChainActions (connect/disconnect/signMessage)
-├── AptosHydrator.test.tsx
-└── index.ts
-```
-
-### `<AptosProvider>`
-
-Wraps the chain's native React provider:
-
-```tsx
-import { type ReactNode } from 'react';
-import { AptosProvider as NativeProvider } from 'aptos-adapter-react';
-import { AptosHydrator } from './AptosHydrator.js';
-import { AptosActions } from './AptosActions.js';
-import type { AptosTypeConfig } from '@/types/config.js';
-
-type AptosProviderProps = {
-  children: ReactNode;
-  config: AptosTypeConfig;
-};
-
-export const AptosProvider = ({ children, config }: AptosProviderProps) => (
-  <NativeProvider network={config.network ?? 'mainnet'} autoConnect={config.autoConnect ?? true}>
-    <AptosHydrator />
-    <AptosActions />
-    {children}
-  </NativeProvider>
-);
-```
-
-### `<AptosHydrator>`
-
-Sole writer. Subscribes to native SDK hooks; writes through `setXConnection` / `setWalletProvider`. **Never** writes inside an event handler — only inside `useEffect` reactions to native state.
-
-```typescript
-import { useAccount } from 'aptos-adapter-react';
-
-export const AptosHydrator = () => {
-  const { address, status, connector } = useAccount();
-  const setXConnection = useXWalletStore(s => s.setXConnection);
-  const unsetXConnection = useXWalletStore(s => s.unsetXConnection);
-
-  useEffect(() => {
-    if (status === 'connected' && address) {
-      setXConnection('APTOS', { xAccount: { address, xChainType: 'APTOS' }, xConnectorId: connector.id });
-    } else if (status === 'disconnected') {
-      unsetXConnection('APTOS');
-    }
-  }, [address, status, connector]);
-
-  // ... build wallet provider similarly via useMemo + setWalletProvider
-
-  return null;
-};
-```
-
-### `<AptosActions>`
-
-Registers `ChainActions` using **refs** to native SDK functions, so the registered closures always call the latest function without re-registering:
-
-```typescript
-const connectRef = useRef(connectAsync);
-useEffect(() => { connectRef.current = connectAsync; }, [connectAsync]);
-
-useEffect(() => {
-  registerChainActions('APTOS', {
-    connect: async (id) => connectRef.current({ connector: id }),
-    disconnect: async () => disconnectRef.current(),
-    // ...
-  });
-}, []); // empty deps — register once
-
-return null;
-```
-
-### Mount in `SodaxWalletProvider.tsx`
-
-```tsx
-{frozen.APTOS && (
-  <AptosProvider config={frozen.APTOS}>
-    {content}
-  </AptosProvider>
-)}
-```
-
----
-
-## Step 8 — barrel surface (`src/index.ts`)
-
-**Do NOT** add `export * from './xchains/aptos'` to the root `src/index.ts`. Concrete classes stay behind sub-path imports.
-
-If consumers need a **type** from the barrel for type-only ergonomics, add an explicit `export type` line:
-
-```typescript
-// src/index.ts
-export type { AptosWalletAddressType } from './xchains/aptos/index.js';
-```
-
-This keeps runtime classes off the barrel but lets consumers `import type { AptosWalletAddressType } from '@sodax/wallet-sdk-react'` without going through the deep import for a type-only reference.
-
-See [`SUB_PATH_EXPORTS.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/SUB_PATH_EXPORTS.md) for why concrete classes are deep-imported.
-
----
-
-## Step 9 — tests
-
-Required test surface per `vitest.config.ts`:
-
-- `AptosXConnector.test.ts` — connector constructor, `connect/disconnect`, `isInstalled`/`installUrl` window probes
-- `AptosXService.test.ts` (or co-located) — singleton behavior, balance reads
-- `AptosWalletProvider.test.ts` (in wallet-sdk-core) — config variants, defaults merge, core method dispatch
-- `AptosHydrator.test.tsx` (provider-managed only) — fake adapter state → assert store writes
-
-Pattern reference: [`EvmHydrator.test.tsx`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/src/providers/evm/EvmHydrator.test.tsx).
-
----
-
-## Verification checklist
-
-Before opening a PR, walk through each item:
-
-- [ ] `pnpm checkTs` passes — `SodaxWalletConfig.APTOS` is recognized; `useWalletProvider({ xChainType: 'APTOS' })` returns the right type.
-- [ ] `pnpm test` passes for new files.
-- [ ] `pnpm build:packages` produces `dist/xchains/aptos/index.{mjs,cjs,d.ts}`.
-- [ ] `import { AptosXService } from '@sodax/wallet-sdk-react/xchains/aptos'` resolves in a consumer app.
-- [ ] `import { AptosXService } from '@sodax/wallet-sdk-react'` is **not** available (intentional — concrete classes stay behind deep imports).
-- [ ] Adding `APTOS: {}` to `SodaxWalletConfig` mounts the chain; omitting the slot skips it.
-- [ ] `useEnabledChains()` includes `'APTOS'` only when the slot is present.
-- [ ] Connect → disconnect cycle updates `xConnections.APTOS` correctly; `localStorage` persists.
-- [ ] On reload, `cleanupDisabledConnections` removes `xConnections.APTOS` if the slot is later removed.
-- [ ] Documentation: add an entry to the connector reference in [`CONNECTORS.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CONNECTORS.md) and the chain-type tables in [`CONFIGURE_PROVIDER.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CONFIGURE_PROVIDER.md).
-
----
-
-## Related docs
-
-- [Architecture](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/ARCHITECTURE.md) — store + registry + Hydrator pattern
-- [Sub-path Exports](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/SUB_PATH_EXPORTS.md) — barrel vs deep-import boundary
-- [Configure SodaxWalletProvider](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CONFIGURE_PROVIDER.md) — config schema (auto-extends from `ChainMeta`)
-- [Connectors](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CONNECTORS.md) — IXConnector contract + sub-path map
-- [`packages/wallet-sdk-core/CLAUDE.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-core/CLAUDE.md) — wallet provider class patterns
-- [`packages/types/CLAUDE.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/types/CLAUDE.md) — interface conventions