@tuwaio/pulsar-solana 0.6.4 → 0.6.5

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.
Files changed (4) hide show
  1. package/README.md +9 -9
  2. package/dist/index.d.mts +1 -1
  3. package/dist/index.d.ts +1 -1
  4. package/package.json +11 -11
package/README.md CHANGED
@@ -4,13 +4,13 @@
4
4
  [![License](https://img.shields.io/npm/l/@tuwaio/pulsar-solana.svg)](./LICENSE)
5
5
  [![Build Status](https://img.shields.io/github/actions/workflow/status/TuwaIO/pulsar-core/release.yml?branch=main)](https://github.com/TuwaIO/pulsar-core/actions)
6
6
 
7
- An advanced toolkit for the Pulsar Engine that adds comprehensive support for tracking transactions on the Solana blockchain. It is built to leverage **Wallet Standard**, integrating seamlessly with modern Solana wallet ecosystems, and uses **`gill`** for modern blockchain interaction.
7
+ Tier 4 of the TUWA Ecosystem. Low-level Solana block state monitors and RPC cluster lifecycle indexers powered strictly by gill.
8
8
 
9
9
  ---
10
10
 
11
11
  ## 🏛️ What is `@tuwaio/pulsar-solana`?
12
12
 
13
- This package is a powerful, official adapter for `@tuwaio/pulsar-core`. It's designed to be compatible with wallets that follow the **Wallet Standard**. By leveraging standard wallet interfaces, you can utilize Pulsar's powerful transaction tracking engine across a wide range of Solana wallets.
13
+ This package is the low-level Solana block state monitor and RPC cluster lifecycle indexing adapter for `@tuwaio/pulsar-core`. It leverages **Wallet Standard** for deep integration with modern Solana wallet environments, performing fast-block signature status tracking, signature swap detection, and cluster manager alignment using `gill` primitives.
14
14
 
15
15
  The architecture is designed for multi-chain robustness. You can provide RPC endpoints for different Solana clusters (e.g., Mainnet Beta, Devnet), and the adapter will automatically use the correct one based on the user's connected wallet state.
16
16
 
@@ -18,11 +18,11 @@ The architecture is designed for multi-chain robustness. You can provide RPC end
18
18
 
19
19
  ## ✨ Core Features
20
20
 
21
- - **🔌 Wallet Standard Integration:** A single `pulsarSolanaAdapter` factory that works with any wallet supporting the **Wallet Standard**.
22
- - **🔗 Multi-Chain RPC:** Configure with a map of RPC URLs for different clusters; the adapter intelligently selects the correct one.
23
- - **🛰️ Robust Polling Tracker:** A durable transaction tracker that polls for signature statuses until finality.
24
- - **🌐 Network Verification:** Includes a utility (`checkSolanaChain`) to verify that the connected wallet's cluster matches the one required by the transaction.
25
- - **💡 Optional Wallet:** The adapter can be initialized without a wallet for read-only operations, such as displaying transaction history.
21
+ - **🔌 Wallet Standard Integration:** A single `pulsarSolanaAdapter` factory that interfaces with any wallet conforming to the **Wallet Standard**.
22
+ - **🔗 Multi-Chain RPC:** Configuration mapping for RPC endpoints across multiple Solana clusters (mainnet-beta, devnet, testnet).
23
+ - **🛰️ Signature Swap & Status Tracker:** A high-speed transaction signature monitor that checks RPC node block states and tracks signature mutations.
24
+ - **🌐 Cluster Verification:** Includes a pre-flight validator (`checkSolanaChain`) to ensure the connected wallet's cluster matches the transaction's target network.
25
+ - **💡 Read-Only Operations:** The adapter can initialize without wallet contexts to fetch and parse histories.
26
26
 
27
27
  ---
28
28
 
@@ -106,7 +106,7 @@ import { useWalletAccountTransactionSendingSigner } from '@solana/react';
106
106
  import { Wallet } from '@tuwaio/nova-connect/satellite';
107
107
  import { OrbitAdapter } from '@tuwaio/orbit-core';
108
108
  import { createSolanaClientWithCache } from '@tuwaio/orbit-solana';
109
- import { SolanaWallet } from '@tuwaio/satellite-solana';
109
+ import { SolanaConnection } from '@tuwaio/satellite-solana';
110
110
 
111
111
  import { usePulsarStore } from '@/hooks/pulsarStoreHook';
112
112
 
@@ -127,7 +127,7 @@ function MyTransactionButton() {
127
127
  const getLastTxKey = usePulsarStore((state) => state.getLastTxKey);
128
128
  const activeConnection = useSatelliteConnectStore((state) => state.activeConnection);
129
129
 
130
- const activeWalletSolana = activeConnection as SolanaWallet;
130
+ const activeWalletSolana = activeConnection as SolanaConnection;
131
131
 
132
132
  const signer = useWalletAccountTransactionSendingSigner(
133
133
  activeWalletSolana.connectedAccount as UiWalletAccount,
package/dist/index.d.mts CHANGED
@@ -45,7 +45,7 @@ declare function pulsarSolanaAdapter<T extends Transaction>(config: SolanaAdapte
45
45
  * implement custom logic, such as prompting the user to switch networks.
46
46
  */
47
47
  declare class SolanaChainMismatchError extends Error {
48
- /** The name of the error, for easy identification. */
48
+ /** The name identifier of the error class. */
49
49
  name: string;
50
50
  /** The chain that the transaction requires (e.g., 'solana:mainnet'). */
51
51
  requiredChain: string;
package/dist/index.d.ts CHANGED
@@ -45,7 +45,7 @@ declare function pulsarSolanaAdapter<T extends Transaction>(config: SolanaAdapte
45
45
  * implement custom logic, such as prompting the user to switch networks.
46
46
  */
47
47
  declare class SolanaChainMismatchError extends Error {
48
- /** The name of the error, for easy identification. */
48
+ /** The name identifier of the error class. */
49
49
  name: string;
50
50
  /** The chain that the transaction requires (e.g., 'solana:mainnet'). */
51
51
  requiredChain: string;
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "@tuwaio/pulsar-solana",
3
- "version": "0.6.4",
3
+ "version": "0.6.5",
4
4
  "private": false,
5
5
  "author": "Oleksandr Tkach",
6
6
  "license": "Apache-2.0",
7
- "description": "An adapter for the Pulsar Engine that adds support for tracking transactions on the Solana blockchain.",
7
+ "description": "Tier 4 of the TUWA Ecosystem. Low-level Solana block state monitors and RPC cluster lifecycle indexers powered strictly by gill.",
8
8
  "main": "./dist/index.js",
9
9
  "module": "./dist/index.mjs",
10
10
  "types": "./dist/index.d.ts",
@@ -50,20 +50,20 @@
50
50
  "zustand": "5.x.x"
51
51
  },
52
52
  "devDependencies": {
53
- "@tuwaio/orbit-core": "^0.2.8",
54
- "@tuwaio/orbit-solana": "^0.2.6",
55
- "@wallet-standard/app": "^1.1.0",
56
- "@wallet-standard/ui-core": "^1.0.0",
57
- "@wallet-standard/ui-registry": "^1.1.0",
53
+ "@tuwaio/orbit-core": "^0.2.12",
54
+ "@tuwaio/orbit-solana": "^0.2.10",
55
+ "@wallet-standard/app": "^1.1.1",
56
+ "@wallet-standard/ui-core": "^1.0.1",
57
+ "@wallet-standard/ui-registry": "^1.1.1",
58
58
  "dayjs": "^1.11.21",
59
59
  "gill": "^0.14.0",
60
- "immer": "^11.1.8",
60
+ "immer": "^11.1.9",
61
61
  "jsdom": "^29.1.1",
62
62
  "tsup": "^8.5.1",
63
63
  "typescript": "^6.0.3",
64
- "vitest": "^4.1.7",
65
- "zustand": "^5.0.13",
66
- "@tuwaio/pulsar-core": "^0.6.4"
64
+ "vitest": "^4.1.9",
65
+ "zustand": "^5.0.14",
66
+ "@tuwaio/pulsar-core": "^0.6.5"
67
67
  },
68
68
  "scripts": {
69
69
  "start": "tsup src/index.ts --watch",