@chipi-stack/chipi-react 14.8.0 → 14.10.0

package/dist/index.d.mts

@@ -4,8 +4,12 @@ import { ChipiSDK, NewOwnerInput } from '@chipi-stack/backend';
 import { ChipiSDKConfig } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 export { Chain, ChainToken } from '@chipi-stack/types';
-export { ChipiWalletData, SessionState, SessionWallet, ThresholdSignState, UseChipiSessionConfig, UseChipiSessionReturn, UseChipiWalletConfig, UseChipiWalletReturn, UseGuardianRecoveryReturn, UseShhhSignerReturn, UseThresholdSignOptions, UseThresholdSignReturn, UseTransferConfig, UseX402PaymentConfig, UseX402PaymentReturn, useAddSessionKeyToContract, useApprove, useCallAnyContract, useChipiSession, useChipiWallet, useCreateSessionKey, useCreateWallet, useExecuteWithSession, useGetSessionData, useGetSku, useGetSkuList, useGetSkuPurchase, useGetTokenBalance, useGetTransaction, useGetTransactionList, useGetTransactionStatus, useGetWallet, useGuardianRecovery, useMigrateWalletToPasskey, useMigrateWalletToShhh, usePurchaseSku, useRecordSendTransaction, useRevokeSessionKey, useShhhSigner, useSyncOnChainTransfers, useThresholdSign, useTransfer, useUpdateWalletEncryption, useX402Payment } from './hooks.mjs';
+import { C as ChipiWindowObjectDeps, U as UseChipiWalletObjectConfig } from './index-D9-uVlda.mjs';
+export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, g as ChipiWalletData, a1 as PrivacyConfig, a2 as PrivacyKeys, a5 as PrivacyLedgerEvent, a3 as PrivacyStep, a6 as PrivateBalanceInput, S as SessionState, k as SessionWallet, a4 as ShieldHookInput, X as ThresholdSignState, i as UseChipiSessionConfig, j as UseChipiSessionReturn, e as UseChipiWalletConfig, f as UseChipiWalletReturn, R as UseGuardianRecoveryReturn, P as UseShhhSignerReturn, W as UseThresholdSignOptions, V as UseThresholdSignReturn, p as UseTransferConfig, M as UseX402PaymentConfig, N as UseX402PaymentReturn, $ as derivePrivacyAccount, a0 as netPrivateBalance, H as useAddSessionKeyToContract, q as useApprove, A as useCallAnyContract, h as useChipiSession, d as useChipiWallet, D as useChipiWalletObject, G as useCreateSessionKey, u as useCreateWallet, K as useExecuteWithSession, J as useGetSessionData, z as useGetSku, y as useGetSkuList, x as useGetSkuPurchase, F as useGetTokenBalance, s as useGetTransaction, r as useGetTransactionList, t as useGetTransactionStatus, c as useGetWallet, Q as useGuardianRecovery, l as useMigrateWalletToPasskey, n as useMigrateWalletToShhh, _ as usePrivateBalance, w as usePurchaseSku, E as useRecordSendTransaction, I as useRevokeSessionKey, O as useShhhSigner, Y as useShield, B as useSignTypedData, v as useSyncOnChainTransfers, T as useThresholdSign, o as useTransfer, Z as useUnshield, m as useUpdateWalletEncryption, L as useX402Payment } from './index-D9-uVlda.mjs';
+import { StarknetWindowObject } from '@starknet-io/types-js';
 import '@tanstack/react-query';
+import 'starknet';
+import '@chipi-stack/core';
 
 interface PasskeyAdapter {
     getWalletEncryptKey: (input: {
@@ -31,6 +35,61 @@ declare function ChipiProvider({ children, config, passkeyAdapter }: ChipiProvid
  */
 declare function useChipiContext(): ChipiContextValue;
 
+/**
+ * Build a standards-compliant Starknet `StarknetWindowObject` backed by a Chipi
+ * wallet. Framework-agnostic: all signing/execution/approval is injected via
+ * `deps`, so the same object powers walletv2's in-app browser, the hosted
+ * web-wallet connector, and WalletConnect transport identically.
+ *
+ * Returns the wallet plus an `emit` controller so the host can fire
+ * accountsChanged / networkChanged on connect, disconnect, or lock.
+ */
+declare function createChipiWindowObject(deps: ChipiWindowObjectDeps): {
+    wallet: StarknetWindowObject;
+    emit: {
+        accountsChanged: (accounts: string[]) => void;
+        networkChanged: (chainId: string, accounts?: string[]) => void;
+    };
+};
+
+interface InjectedChipiWallet {
+    /** The injected StarknetWindowObject (also reachable at window.starknet_chipi). */
+    wallet: ReturnType<typeof createChipiWindowObject>["wallet"];
+    /** Fire accountsChanged / networkChanged to connected dApps. */
+    emit: ReturnType<typeof createChipiWindowObject>["emit"];
+    /** Remove the injected object + event listeners. */
+    dispose: () => void;
+}
+/**
+ * Inject a Chipi `StarknetWindowObject` so any dApp built on get-starknet /
+ * starknet-react / starknetkit discovers it as a connectable wallet.
+ *
+ * Discovery is covered two ways for max reach:
+ *  1. **Window scan** — set `window.starknet_chipi`. get-starknet v4's
+ *     `getAvailableWallets()` finds every `window` key starting with `starknet`.
+ *  2. **Event announce** — dispatch `starknet:announceWallet` (and re-announce
+ *     on the dApp's `starknet:requestWallets`), the timing-robust, EIP-6963-style
+ *     discovery used by newer get-starknet / the Starknet Wallet Standard.
+ *
+ * Returns a controller to emit account/network changes and to dispose.
+ * Only meaningful where Chipi can inject into the dApp page — an in-app browser
+ * (native shell) or extension; a hosted wallet on a third-party domain uses the
+ * connector path instead.
+ */
+declare function injectChipiWallet(deps: ChipiWindowObjectDeps, target?: (Window & typeof globalThis) | undefined): InjectedChipiWallet;
+
+interface ChipiInjectorProps extends UseChipiWalletObjectConfig {
+    children?: ReactNode;
+}
+/**
+ * Inject a Chipi `StarknetWindowObject` into the page so any dApp loaded here
+ * (in-app browser / native-shell webview) discovers it via get-starknet /
+ * starknet-react / starknetkit. Composes execution + signing + session-first
+ * routing from the SDK hooks. Mount it once high in the wallet's in-app browser
+ * tree. Emits `accountsChanged` when the connected wallet changes.
+ */
+declare function ChipiInjector({ children, ...config }: ChipiInjectorProps): ReactNode;
+
 /**
  * SHHH V8.4 standalone recovery component (Wave B B6.2).
  *
@@ -105,4 +164,4 @@ interface RecoverProps {
 }
 declare function Recover(props: RecoverProps): React.ReactElement;
 
-export { ChipiProvider, type PasskeyAdapter, Recover, type RecoverProps, useChipiContext };
+export { ChipiInjector, type ChipiInjectorProps, ChipiProvider, ChipiWindowObjectDeps, type InjectedChipiWallet, type PasskeyAdapter, Recover, type RecoverProps, UseChipiWalletObjectConfig, createChipiWindowObject, injectChipiWallet, useChipiContext };

package/dist/index.d.ts

@@ -4,8 +4,12 @@ import { ChipiSDK, NewOwnerInput } from '@chipi-stack/backend';
 import { ChipiSDKConfig } from '@chipi-stack/types';
 export * from '@chipi-stack/types';
 export { Chain, ChainToken } from '@chipi-stack/types';
-export { ChipiWalletData, SessionState, SessionWallet, ThresholdSignState, UseChipiSessionConfig, UseChipiSessionReturn, UseChipiWalletConfig, UseChipiWalletReturn, UseGuardianRecoveryReturn, UseShhhSignerReturn, UseThresholdSignOptions, UseThresholdSignReturn, UseTransferConfig, UseX402PaymentConfig, UseX402PaymentReturn, useAddSessionKeyToContract, useApprove, useCallAnyContract, useChipiSession, useChipiWallet, useCreateSessionKey, useCreateWallet, useExecuteWithSession, useGetSessionData, useGetSku, useGetSkuList, useGetSkuPurchase, useGetTokenBalance, useGetTransaction, useGetTransactionList, useGetTransactionStatus, useGetWallet, useGuardianRecovery, useMigrateWalletToPasskey, useMigrateWalletToShhh, usePurchaseSku, useRecordSendTransaction, useRevokeSessionKey, useShhhSigner, useSyncOnChainTransfers, useThresholdSign, useTransfer, useUpdateWalletEncryption, useX402Payment } from './hooks.js';
+import { C as ChipiWindowObjectDeps, U as UseChipiWalletObjectConfig } from './index-D9-uVlda.js';
+export { a as ChipiApprovalRequest, b as ChipiSessionPolicy, g as ChipiWalletData, a1 as PrivacyConfig, a2 as PrivacyKeys, a5 as PrivacyLedgerEvent, a3 as PrivacyStep, a6 as PrivateBalanceInput, S as SessionState, k as SessionWallet, a4 as ShieldHookInput, X as ThresholdSignState, i as UseChipiSessionConfig, j as UseChipiSessionReturn, e as UseChipiWalletConfig, f as UseChipiWalletReturn, R as UseGuardianRecoveryReturn, P as UseShhhSignerReturn, W as UseThresholdSignOptions, V as UseThresholdSignReturn, p as UseTransferConfig, M as UseX402PaymentConfig, N as UseX402PaymentReturn, $ as derivePrivacyAccount, a0 as netPrivateBalance, H as useAddSessionKeyToContract, q as useApprove, A as useCallAnyContract, h as useChipiSession, d as useChipiWallet, D as useChipiWalletObject, G as useCreateSessionKey, u as useCreateWallet, K as useExecuteWithSession, J as useGetSessionData, z as useGetSku, y as useGetSkuList, x as useGetSkuPurchase, F as useGetTokenBalance, s as useGetTransaction, r as useGetTransactionList, t as useGetTransactionStatus, c as useGetWallet, Q as useGuardianRecovery, l as useMigrateWalletToPasskey, n as useMigrateWalletToShhh, _ as usePrivateBalance, w as usePurchaseSku, E as useRecordSendTransaction, I as useRevokeSessionKey, O as useShhhSigner, Y as useShield, B as useSignTypedData, v as useSyncOnChainTransfers, T as useThresholdSign, o as useTransfer, Z as useUnshield, m as useUpdateWalletEncryption, L as useX402Payment } from './index-D9-uVlda.js';
+import { StarknetWindowObject } from '@starknet-io/types-js';
 import '@tanstack/react-query';
+import 'starknet';
+import '@chipi-stack/core';
 
 interface PasskeyAdapter {
     getWalletEncryptKey: (input: {
@@ -31,6 +35,61 @@ declare function ChipiProvider({ children, config, passkeyAdapter }: ChipiProvid
  */
 declare function useChipiContext(): ChipiContextValue;
 
+/**
+ * Build a standards-compliant Starknet `StarknetWindowObject` backed by a Chipi
+ * wallet. Framework-agnostic: all signing/execution/approval is injected via
+ * `deps`, so the same object powers walletv2's in-app browser, the hosted
+ * web-wallet connector, and WalletConnect transport identically.
+ *
+ * Returns the wallet plus an `emit` controller so the host can fire
+ * accountsChanged / networkChanged on connect, disconnect, or lock.
+ */
+declare function createChipiWindowObject(deps: ChipiWindowObjectDeps): {
+    wallet: StarknetWindowObject;
+    emit: {
+        accountsChanged: (accounts: string[]) => void;
+        networkChanged: (chainId: string, accounts?: string[]) => void;
+    };
+};
+
+interface InjectedChipiWallet {
+    /** The injected StarknetWindowObject (also reachable at window.starknet_chipi). */
+    wallet: ReturnType<typeof createChipiWindowObject>["wallet"];
+    /** Fire accountsChanged / networkChanged to connected dApps. */
+    emit: ReturnType<typeof createChipiWindowObject>["emit"];
+    /** Remove the injected object + event listeners. */
+    dispose: () => void;
+}
+/**
+ * Inject a Chipi `StarknetWindowObject` so any dApp built on get-starknet /
+ * starknet-react / starknetkit discovers it as a connectable wallet.
+ *
+ * Discovery is covered two ways for max reach:
+ *  1. **Window scan** — set `window.starknet_chipi`. get-starknet v4's
+ *     `getAvailableWallets()` finds every `window` key starting with `starknet`.
+ *  2. **Event announce** — dispatch `starknet:announceWallet` (and re-announce
+ *     on the dApp's `starknet:requestWallets`), the timing-robust, EIP-6963-style
+ *     discovery used by newer get-starknet / the Starknet Wallet Standard.
+ *
+ * Returns a controller to emit account/network changes and to dispose.
+ * Only meaningful where Chipi can inject into the dApp page — an in-app browser
+ * (native shell) or extension; a hosted wallet on a third-party domain uses the
+ * connector path instead.
+ */
+declare function injectChipiWallet(deps: ChipiWindowObjectDeps, target?: (Window & typeof globalThis) | undefined): InjectedChipiWallet;
+
+interface ChipiInjectorProps extends UseChipiWalletObjectConfig {
+    children?: ReactNode;
+}
+/**
+ * Inject a Chipi `StarknetWindowObject` into the page so any dApp loaded here
+ * (in-app browser / native-shell webview) discovers it via get-starknet /
+ * starknet-react / starknetkit. Composes execution + signing + session-first
+ * routing from the SDK hooks. Mount it once high in the wallet's in-app browser
+ * tree. Emits `accountsChanged` when the connected wallet changes.
+ */
+declare function ChipiInjector({ children, ...config }: ChipiInjectorProps): ReactNode;
+
 /**
  * SHHH V8.4 standalone recovery component (Wave B B6.2).
  *
@@ -105,4 +164,4 @@ interface RecoverProps {
 }
 declare function Recover(props: RecoverProps): React.ReactElement;
 
-export { ChipiProvider, type PasskeyAdapter, Recover, type RecoverProps, useChipiContext };
+export { ChipiInjector, type ChipiInjectorProps, ChipiProvider, ChipiWindowObjectDeps, type InjectedChipiWallet, type PasskeyAdapter, Recover, type RecoverProps, UseChipiWalletObjectConfig, createChipiWindowObject, injectChipiWallet, useChipiContext };