@solana/react-hooks 1.0.0-rc.1 → 1.0.0-rc.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +224 -340
- package/dist/index.browser.cjs +11 -5
- package/dist/index.browser.cjs.map +1 -1
- package/dist/index.browser.mjs +11 -5
- package/dist/index.browser.mjs.map +1 -1
- package/dist/index.native.mjs +11 -5
- package/dist/index.native.mjs.map +1 -1
- package/dist/index.node.cjs +11 -5
- package/dist/index.node.cjs.map +1 -1
- package/dist/index.node.mjs +11 -5
- package/dist/index.node.mjs.map +1 -1
- package/dist/types/hooks.d.ts +101 -7
- package/dist/types/hooks.d.ts.map +1 -1
- package/dist/types/query.d.ts +17 -0
- package/dist/types/query.d.ts.map +1 -1
- package/dist/types/queryHooks.d.ts +28 -0
- package/dist/types/queryHooks.d.ts.map +1 -1
- package/dist/types/ui.d.ts +33 -1
- package/dist/types/ui.d.ts.map +1 -1
- package/package.json +2 -2
package/dist/types/hooks.d.ts
CHANGED
|
@@ -22,22 +22,54 @@ type UseBalanceOptions = Readonly<{
|
|
|
22
22
|
}> & UseAccountOptions;
|
|
23
23
|
/**
|
|
24
24
|
* Read the full cluster state managed by the client store.
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* ```ts
|
|
28
|
+
* const cluster = useClusterState();
|
|
29
|
+
* console.log(cluster.endpoint, cluster.status);
|
|
30
|
+
* ```
|
|
25
31
|
*/
|
|
26
32
|
export declare function useClusterState(): ClusterState;
|
|
27
33
|
/**
|
|
28
|
-
* Read the
|
|
34
|
+
* Read just the cluster connection status slice (connecting/ready/error).
|
|
35
|
+
*
|
|
36
|
+
* @example
|
|
37
|
+
* ```ts
|
|
38
|
+
* const status = useClusterStatus();
|
|
39
|
+
* if (status.status === 'error') console.error(status.error);
|
|
40
|
+
* ```
|
|
29
41
|
*/
|
|
30
42
|
export declare function useClusterStatus(): ClusterStatus;
|
|
31
43
|
/**
|
|
32
|
-
* Access the wallet status tracked by the client store.
|
|
44
|
+
* Access the wallet status tracked by the client store (connected/connecting/error/disconnected).
|
|
45
|
+
*
|
|
46
|
+
* @example
|
|
47
|
+
* ```ts
|
|
48
|
+
* const wallet = useWallet();
|
|
49
|
+
* if (wallet.status === 'connected') {
|
|
50
|
+
* console.log(wallet.session.account.address.toString());
|
|
51
|
+
* }
|
|
52
|
+
* ```
|
|
33
53
|
*/
|
|
34
54
|
export declare function useWallet(): WalletStatus;
|
|
35
55
|
/**
|
|
36
|
-
* Convenience helper that returns the active wallet session when connected
|
|
56
|
+
* Convenience helper that returns the active wallet session when connected, otherwise `undefined`.
|
|
57
|
+
*
|
|
58
|
+
* @example
|
|
59
|
+
* ```ts
|
|
60
|
+
* const session = useWalletSession();
|
|
61
|
+
* const address = session?.account.address.toString();
|
|
62
|
+
* ```
|
|
37
63
|
*/
|
|
38
64
|
export declare function useWalletSession(): WalletSession | undefined;
|
|
39
65
|
/**
|
|
40
|
-
* Access the headless client actions.
|
|
66
|
+
* Access the headless client actions (setCluster, fetchAccount, connectWallet, etc.).
|
|
67
|
+
*
|
|
68
|
+
* @example
|
|
69
|
+
* ```ts
|
|
70
|
+
* const actions = useWalletActions();
|
|
71
|
+
* await actions.connectWallet('phantom');
|
|
72
|
+
* ```
|
|
41
73
|
*/
|
|
42
74
|
export declare function useWalletActions(): Readonly<{
|
|
43
75
|
connectWallet(connectorId: import("@solana/client").ConnectWalletParameters["connectorId"], options?: import("@solana/client").ConnectWalletParameters["options"]): import("@solana/client").ConnectWalletReturnType;
|
|
@@ -50,17 +82,36 @@ export declare function useWalletActions(): Readonly<{
|
|
|
50
82
|
}>;
|
|
51
83
|
/**
|
|
52
84
|
* Stable connect helper that resolves to {@link ClientActions.connectWallet}.
|
|
85
|
+
*
|
|
86
|
+
* @example
|
|
87
|
+
* ```ts
|
|
88
|
+
* const connect = useConnectWallet();
|
|
89
|
+
* await connect('phantom', { autoConnect: true });
|
|
90
|
+
* ```
|
|
53
91
|
*/
|
|
54
92
|
export declare function useConnectWallet(): (connectorId: string, options?: Readonly<{
|
|
55
93
|
autoConnect?: boolean;
|
|
56
94
|
}>) => Promise<void>;
|
|
57
95
|
/**
|
|
58
96
|
* Stable disconnect helper mapping to {@link ClientActions.disconnectWallet}.
|
|
97
|
+
*
|
|
98
|
+
* @example
|
|
99
|
+
* ```ts
|
|
100
|
+
* const disconnect = useDisconnectWallet();
|
|
101
|
+
* await disconnect();
|
|
102
|
+
* ```
|
|
59
103
|
*/
|
|
60
104
|
export declare function useDisconnectWallet(): () => Promise<void>;
|
|
61
105
|
type SolTransferSignature = UnwrapPromise<ReturnType<SolTransferHelper['sendTransfer']>>;
|
|
62
106
|
/**
|
|
63
107
|
* Convenience wrapper around the SOL transfer helper that tracks status and signature.
|
|
108
|
+
*
|
|
109
|
+
* @example
|
|
110
|
+
* ```ts
|
|
111
|
+
* const { send, signature, status } = useSolTransfer();
|
|
112
|
+
* await send({ amount: 1_000_000n, destination: toAddress('...') });
|
|
113
|
+
* console.log(signature, status);
|
|
114
|
+
* ```
|
|
64
115
|
*/
|
|
65
116
|
export declare function useSolTransfer(): Readonly<{
|
|
66
117
|
error: unknown;
|
|
@@ -82,6 +133,14 @@ type UseSplTokenOptions = Readonly<{
|
|
|
82
133
|
}>;
|
|
83
134
|
/**
|
|
84
135
|
* Simplified SPL token hook that scopes helpers by mint and manages balance state.
|
|
136
|
+
*
|
|
137
|
+
* @example
|
|
138
|
+
* ```ts
|
|
139
|
+
* const { balance, send, owner } = useSplToken(mintAddress);
|
|
140
|
+
* if (owner && balance?.exists) {
|
|
141
|
+
* await send({ amount: 1n, destinationOwner: toAddress('...') });
|
|
142
|
+
* }
|
|
143
|
+
* ```
|
|
85
144
|
*/
|
|
86
145
|
export declare function useSplToken(mint: AddressLike, options?: UseSplTokenOptions): Readonly<{
|
|
87
146
|
balance: SplTokenBalanceResult | null;
|
|
@@ -101,10 +160,21 @@ export declare function useSplToken(mint: AddressLike, options?: UseSplTokenOpti
|
|
|
101
160
|
}>;
|
|
102
161
|
/**
|
|
103
162
|
* Subscribe to the account cache for a given address, optionally triggering fetch & watch helpers.
|
|
163
|
+
*
|
|
164
|
+
* @example
|
|
165
|
+
* ```ts
|
|
166
|
+
* const account = useAccount(pubkey, { watch: true });
|
|
167
|
+
* const lamports = account?.lamports ?? null;
|
|
168
|
+
* ```
|
|
104
169
|
*/
|
|
105
170
|
export declare function useAccount(addressLike?: AddressLike, options?: UseAccountOptions): AccountCacheEntry | undefined;
|
|
106
171
|
/**
|
|
107
|
-
*
|
|
172
|
+
* Track lamport balance for an address. Fetches immediately and watches by default.
|
|
173
|
+
*
|
|
174
|
+
* @example
|
|
175
|
+
* ```ts
|
|
176
|
+
* const { lamports, fetching } = useBalance(pubkey);
|
|
177
|
+
* ```
|
|
108
178
|
*/
|
|
109
179
|
export declare function useBalance(addressLike?: AddressLike, options?: UseBalanceOptions): Readonly<{
|
|
110
180
|
account?: AccountCacheEntry;
|
|
@@ -123,7 +193,15 @@ type UseTransactionPoolSendOptions = TransactionPoolSendOptions;
|
|
|
123
193
|
type UseTransactionPoolPrepareAndSendOptions = TransactionPoolPrepareAndSendOptions;
|
|
124
194
|
type TransactionSignature = Signature;
|
|
125
195
|
/**
|
|
126
|
-
* Manage a mutable set of instructions and use the transaction helper to prepare
|
|
196
|
+
* Manage a mutable set of instructions and use the transaction helper to prepare/sign/send.
|
|
197
|
+
*
|
|
198
|
+
* @example
|
|
199
|
+
* ```ts
|
|
200
|
+
* const pool = useTransactionPool();
|
|
201
|
+
* pool.addInstruction(ix);
|
|
202
|
+
* const prepared = await pool.prepare({ feePayer });
|
|
203
|
+
* await pool.send();
|
|
204
|
+
* ```
|
|
127
205
|
*/
|
|
128
206
|
export declare function useTransactionPool(config?: UseTransactionPoolConfig): Readonly<{
|
|
129
207
|
addInstruction(instruction: TransactionInstructionInput): void;
|
|
@@ -160,6 +238,12 @@ type UseSendTransactionResult = Readonly<{
|
|
|
160
238
|
}>;
|
|
161
239
|
/**
|
|
162
240
|
* General-purpose helper that prepares and sends arbitrary transactions through {@link TransactionHelper}.
|
|
241
|
+
*
|
|
242
|
+
* @example
|
|
243
|
+
* ```ts
|
|
244
|
+
* const { send, status } = useSendTransaction();
|
|
245
|
+
* await send({ instructions: [ix], feePayer });
|
|
246
|
+
* ```
|
|
163
247
|
*/
|
|
164
248
|
export declare function useSendTransaction(): UseSendTransactionResult;
|
|
165
249
|
export type UseSignatureStatusOptions = Readonly<{
|
|
@@ -176,6 +260,11 @@ type SignatureStatusState = SolanaQueryResult<SignatureStatusValue | null> & Rea
|
|
|
176
260
|
}>;
|
|
177
261
|
/**
|
|
178
262
|
* Fetch the RPC status for a transaction signature.
|
|
263
|
+
*
|
|
264
|
+
* @example
|
|
265
|
+
* ```ts
|
|
266
|
+
* const { signatureStatus, confirmationStatus } = useSignatureStatus(sig);
|
|
267
|
+
* ```
|
|
179
268
|
*/
|
|
180
269
|
export declare function useSignatureStatus(signatureInput?: SignatureLike, options?: UseSignatureStatusOptions): SignatureStatusState;
|
|
181
270
|
export type SignatureWaitStatus = 'error' | 'idle' | 'success' | 'waiting';
|
|
@@ -193,7 +282,12 @@ type WaitForSignatureState = SignatureStatusState & Readonly<{
|
|
|
193
282
|
waitStatus: SignatureWaitStatus;
|
|
194
283
|
}>;
|
|
195
284
|
/**
|
|
196
|
-
*
|
|
285
|
+
* Poll signature status until the desired commitment (or subscription notification) is reached.
|
|
286
|
+
*
|
|
287
|
+
* @example
|
|
288
|
+
* ```ts
|
|
289
|
+
* const { waitStatus, confirmationStatus } = useWaitForSignature(sig, { commitment: 'finalized' });
|
|
290
|
+
* ```
|
|
197
291
|
*/
|
|
198
292
|
export declare function useWaitForSignature(signatureInput?: SignatureLike, options?: UseWaitForSignatureOptions): WaitForSignatureState;
|
|
199
293
|
export type UseAccountParameters = Readonly<{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAW3B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAEzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAE/B,KAAK,oCAAoC,EACzC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAE3B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAe,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAGtE,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,wBAAwB,EAAqB,MAAM,SAAS,CAAC;AACnG,OAAO,EAAE,KAAK,4BAA4B,EAAE,KAAK,4BAA4B,EAAsB,MAAM,cAAc,CAAC;AAKxH,KAAK,YAAY,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAC3C,KAAK,aAAa,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;AACtD,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3D,KAAK,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;AAElD,KAAK,qBAAqB,GAAG,UAAU,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAE7E,KAAK,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEpF,KAAK,oBAAoB,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,KAAK,qBAAqB,GAAG,UAAU,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhF,KAAK,iBAAiB,GAAG,QAAQ,CAAC;IACjC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AAEH,KAAK,iBAAiB,GAAG,QAAQ,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,GACD,iBAAiB,CAAC;AAiEnB
|
|
1
|
+
{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"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"}
|
package/dist/types/query.d.ts
CHANGED
|
@@ -17,5 +17,22 @@ export type SolanaQueryResult<Data> = Readonly<{
|
|
|
17
17
|
refresh(): Promise<Data | undefined>;
|
|
18
18
|
status: QueryStatus;
|
|
19
19
|
}>;
|
|
20
|
+
/**
|
|
21
|
+
* Low-level RPC query helper that scopes SWR keys to the active cluster and exposes a Solana-friendly
|
|
22
|
+
* status shape. Prefer this when you need custom fetch logic beyond the built-in hooks.
|
|
23
|
+
*
|
|
24
|
+
* @param scope - Namespace label for the query key (for debugging and cache clarity).
|
|
25
|
+
* @param args - Additional key params that uniquely identify the query (e.g. signature, address).
|
|
26
|
+
* @param fetcher - Async function that receives the current {@link SolanaClient} and returns data.
|
|
27
|
+
* @param options - Optional flags to disable the query or pass through SWR configuration.
|
|
28
|
+
* @example
|
|
29
|
+
* ```ts
|
|
30
|
+
* const slotQuery = useSolanaRpcQuery(
|
|
31
|
+
* 'slot',
|
|
32
|
+
* ['slot'],
|
|
33
|
+
* (client) => client.runtime.rpc.getLatestBlockhash().send().then((r) => r.context.slot),
|
|
34
|
+
* );
|
|
35
|
+
* ```
|
|
36
|
+
*/
|
|
20
37
|
export declare function useSolanaRpcQuery<Data>(scope: string, args: readonly unknown[], fetcher: (client: SolanaClient) => Promise<Data>, options?: UseSolanaRpcQueryOptions<Data>): SolanaQueryResult<Data>;
|
|
21
38
|
//# sourceMappingURL=query.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAe,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAQxF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnE,MAAM,MAAM,wBAAwB,CAAC,IAAI,IAAI,QAAQ,CAAC;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,CAAC,IAAI,IAAI,QAAQ,CAAC;IAC9C,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IACrC,MAAM,EAAE,WAAW,CAAC;CACpB,CAAC,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EACrC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EAChD,OAAO,GAAE,wBAAwB,CAAC,IAAI,CAAM,GAC1C,iBAAiB,CAAC,IAAI,CAAC,CAmDzB"}
|
|
1
|
+
{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAe,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAQxF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnE,MAAM,MAAM,wBAAwB,CAAC,IAAI,IAAI,QAAQ,CAAC;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,CAAC,IAAI,IAAI,QAAQ,CAAC;IAC9C,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IACrC,MAAM,EAAE,WAAW,CAAC;CACpB,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EACrC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EAChD,OAAO,GAAE,wBAAwB,CAAC,IAAI,CAAM,GAC1C,iBAAiB,CAAC,IAAI,CAAC,CAmDzB"}
|
|
@@ -22,6 +22,15 @@ export type UseLatestBlockhashReturnType = SolanaQueryResult<LatestBlockhashResp
|
|
|
22
22
|
contextSlot: bigint | null | undefined;
|
|
23
23
|
lastValidBlockHeight: bigint | null;
|
|
24
24
|
}>;
|
|
25
|
+
/**
|
|
26
|
+
* Fetch the current cluster blockhash and keep it warm with a configurable polling interval.
|
|
27
|
+
* Falls back to the client's active commitment when one is not provided.
|
|
28
|
+
*
|
|
29
|
+
* @example
|
|
30
|
+
* ```ts
|
|
31
|
+
* const { blockhash, lastValidBlockHeight } = useLatestBlockhash({ refreshInterval: 10_000 });
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
25
34
|
export declare function useLatestBlockhash(options?: UseLatestBlockhashParameters): UseLatestBlockhashReturnType;
|
|
26
35
|
export type UseProgramAccountsParameters = Readonly<{
|
|
27
36
|
commitment?: Commitment;
|
|
@@ -33,6 +42,15 @@ export type UseProgramAccountsParameters = Readonly<{
|
|
|
33
42
|
export type UseProgramAccountsReturnType = SolanaQueryResult<ProgramAccountsResponse> & Readonly<{
|
|
34
43
|
accounts: ProgramAccountsResponse;
|
|
35
44
|
}>;
|
|
45
|
+
/**
|
|
46
|
+
* Fetch accounts owned by a program, keyed by the program address. The query is disabled until a
|
|
47
|
+
* program address is provided, and respects both explicit and client default commitments.
|
|
48
|
+
*
|
|
49
|
+
* @example
|
|
50
|
+
* ```ts
|
|
51
|
+
* const programAccounts = useProgramAccounts(programId, { config: { dataSlice: { offset: 0, length: 0 } } });
|
|
52
|
+
* ```
|
|
53
|
+
*/
|
|
36
54
|
export declare function useProgramAccounts(programAddress?: AddressLike, options?: UseProgramAccountsParameters): UseProgramAccountsReturnType;
|
|
37
55
|
export type UseSimulateTransactionParameters = Readonly<{
|
|
38
56
|
commitment?: Commitment;
|
|
@@ -46,6 +64,16 @@ type SimulationInput = (SendableTransaction & Transaction) | Base64EncodedWireTr
|
|
|
46
64
|
export type UseSimulateTransactionReturnType = SolanaQueryResult<SimulateTransactionResponse> & Readonly<{
|
|
47
65
|
logs: readonly string[];
|
|
48
66
|
}>;
|
|
67
|
+
/**
|
|
68
|
+
* Simulate a transaction or wire payload and return simulation logs/results. Disabled until a
|
|
69
|
+
* transaction payload is provided; uses client commitment when not specified in options.
|
|
70
|
+
*
|
|
71
|
+
* @example
|
|
72
|
+
* ```ts
|
|
73
|
+
* const simulation = useSimulateTransaction(base64Wire, { refreshInterval: 0 });
|
|
74
|
+
* console.log(simulation.logs);
|
|
75
|
+
* ```
|
|
76
|
+
*/
|
|
49
77
|
export declare function useSimulateTransaction(transaction?: SimulationInput | null, options?: UseSimulateTransactionParameters): UseSimulateTransactionReturnType;
|
|
50
78
|
export {};
|
|
51
79
|
//# sourceMappingURL=queryHooks.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"queryHooks.d.ts","sourceRoot":"","sources":["../../src/queryHooks.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"queryHooks.d.ts","sourceRoot":"","sources":["../../src/queryHooks.ts"],"names":[],"mappings":"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"}
|
package/dist/types/ui.d.ts
CHANGED
|
@@ -20,7 +20,17 @@ type WalletConnectionOptions = Readonly<{
|
|
|
20
20
|
export type UseWalletConnectionParameters = WalletConnectionOptions;
|
|
21
21
|
export type UseWalletConnectionReturnType = WalletConnectionState;
|
|
22
22
|
/**
|
|
23
|
-
*
|
|
23
|
+
* Collect everything needed to build wallet connection UIs into a single hook.
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* ```tsx
|
|
27
|
+
* const { connectors, connect, disconnect, status } = useWalletConnection();
|
|
28
|
+
* return connectors.map((c) => (
|
|
29
|
+
* <button key={c.id} onClick={() => connect(c.id)} disabled={status === 'connecting'}>
|
|
30
|
+
* {c.name}
|
|
31
|
+
* </button>
|
|
32
|
+
* ));
|
|
33
|
+
* ```
|
|
24
34
|
*/
|
|
25
35
|
export declare function useWalletConnection(options?: WalletConnectionOptions): WalletConnectionState;
|
|
26
36
|
type WalletConnectionManagerProps = Readonly<{
|
|
@@ -29,6 +39,15 @@ type WalletConnectionManagerProps = Readonly<{
|
|
|
29
39
|
}>;
|
|
30
40
|
/**
|
|
31
41
|
* Render-prop helper that lets you easily wire wallet status into custom UIs.
|
|
42
|
+
*
|
|
43
|
+
* @example
|
|
44
|
+
* ```tsx
|
|
45
|
+
* <WalletConnectionManager>
|
|
46
|
+
* {({ connectors, connect }) => connectors.map((c) => (
|
|
47
|
+
* <button key={c.id} onClick={() => connect(c.id)}>{c.name}</button>
|
|
48
|
+
* ))}
|
|
49
|
+
* </WalletConnectionManager>
|
|
50
|
+
* ```
|
|
32
51
|
*/
|
|
33
52
|
export declare function WalletConnectionManager({ children, connectors }: WalletConnectionManagerProps): import("react/jsx-runtime").JSX.Element;
|
|
34
53
|
type WalletModalStateOptions = WalletConnectionOptions & Readonly<{
|
|
@@ -48,6 +67,19 @@ export type UseWalletModalStateReturnType = WalletModalState;
|
|
|
48
67
|
/**
|
|
49
68
|
* Small state machine for wallet selection modals – keeps track of modal visibility and the currently
|
|
50
69
|
* highlighted connector while reusing the connection state returned by {@link useWalletConnection}.
|
|
70
|
+
*
|
|
71
|
+
* @example
|
|
72
|
+
* ```tsx
|
|
73
|
+
* const modal = useWalletModalState();
|
|
74
|
+
* return (
|
|
75
|
+
* <>
|
|
76
|
+
* <button onClick={modal.toggle}>Connect</button>
|
|
77
|
+
* {modal.isOpen && modal.connectors.map((c) => (
|
|
78
|
+
* <button key={c.id} onClick={() => modal.connect(c.id)}>{c.name}</button>
|
|
79
|
+
* ))}
|
|
80
|
+
* </>
|
|
81
|
+
* );
|
|
82
|
+
* ```
|
|
51
83
|
*/
|
|
52
84
|
export declare function useWalletModalState(options?: WalletModalStateOptions): WalletModalState;
|
|
53
85
|
export {};
|
package/dist/types/ui.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/ui.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,KAAK,qBAAqB,GAAG,QAAQ,CAAC;IACrC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;CAClC,CAAC,CAAC;AAEH,KAAK,uBAAuB,GAAG,QAAQ,CAAC;IACvC,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACpE,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAElE
|
|
1
|
+
{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/ui.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,KAAK,qBAAqB,GAAG,QAAQ,CAAC;IACrC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;CAClC,CAAC,CAAC;AAEH,KAAK,uBAAuB,GAAG,QAAQ,CAAC;IACvC,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACpE,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,GAAG,qBAAqB,CAsChG;AAED,KAAK,4BAA4B,GAAG,QAAQ,CAAC;IAC5C,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,SAAS,CAAC;IACtD,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACxC,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,4BAA4B,2CAG7F;AAED,KAAK,uBAAuB,GAAG,uBAAuB,GACrD,QAAQ,CAAC;IACR,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC,CAAC;AAEJ,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GACnD,QAAQ,CAAC;IACR,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,IAAI,IAAI,CAAC;IACb,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,MAAM,IAAI,IAAI,CAAC;CACf,CAAC,CAAC;AAEJ,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACpE,MAAM,MAAM,6BAA6B,GAAG,gBAAgB,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,GAAG,gBAAgB,CAgC3F"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@solana/react-hooks",
|
|
3
|
-
"version": "1.0.0-rc.
|
|
3
|
+
"version": "1.0.0-rc.3",
|
|
4
4
|
"description": "React hooks for the @solana/client Solana client",
|
|
5
5
|
"exports": {
|
|
6
6
|
"edge-light": {
|
|
@@ -59,7 +59,7 @@
|
|
|
59
59
|
"@solana/kit": "^5.0.0",
|
|
60
60
|
"swr": "^2.3.6",
|
|
61
61
|
"zustand": "^5.0.0",
|
|
62
|
-
"@solana/client": "1.0.0-rc.
|
|
62
|
+
"@solana/client": "1.0.0-rc.2"
|
|
63
63
|
},
|
|
64
64
|
"devDependencies": {
|
|
65
65
|
"@types/react": "^19.0.0",
|