@tuwaio/siwx-solana

Solana adapter for @tuwaio/siwx (L2). Verifies CAIP-122 messages for Solana using native ed25519 cryptography via SubtleCrypto. Compatible with all Wallet Standard wallets.

🏛️ Core Capabilities

• ed25519 Verification: Verifies Solana wallet signatures against CAIP-122 messages using the native SubtleCrypto API (no native module dependencies).
• Extracts and validates Solana addresses from CAIP-10 strings using gill.
• Compatible with Node.js (v19+), browsers, and Edge runtimes (Cloudflare Workers, Vercel Edge).

💾 Installation

pnpm add @tuwaio/siwx-solana @tuwaio/siwx-core gill

🚀 API & Module Architecture

verifyEd25519(payload, options?): Promise<SiwxVerifyResult>

Verifies a Solana wallet signature. The signature must be base58-encoded (as produced by all Wallet Standard adapters). Accepts optional options?: { skipExpiration?: boolean }.

import { verifyEd25519 } from '@tuwaio/siwx-solana';

const result = await verifyEd25519({
  message: rawCaip122Message,
  signature: base58EncodedSignature,
});

if (result.success) {
  console.log('Solana auth verified for:', result.data?.address);
}

createSolanaSiwxSigner(signer)

Creates a standard SIWX signer callback for Solana chains. Automatically adapts to Wallet Standard, Web3 v2 (gill), or legacy Solana signers.

import { createSolanaSiwxSigner } from '@tuwaio/siwx-solana';

const signer = createSolanaSiwxSigner(connectedAccount);
const signature = await signer('Message to sign');

Wallet Standard Integration

When using a Wallet Standard compatible wallet (Phantom, Solflare, Backpack), integration is seamless with the factory:

import { useSiwx } from '@tuwaio/siwx-react';
import { createSolanaSiwxSigner } from '@tuwaio/siwx-solana';

const { signIn } = useSiwx();

// `connectedAccount` is the `UiWalletAccount` from `@wallet-standard/react`
const signer = createSolanaSiwxSigner(connectedAccount);

await signIn({ signer, verifier, fields: { ... } });

Peer Dependencies

| Package | Version | | ----------------------- | ------------- | | @tuwaio/siwx-core | workspace:* | | gill | ^0.14.0 | | @wallet-standard/base | ^1.0.0 |

📄 License

Licensed under the Apache-2.0 License. See the LICENSE file for details.