Keychain

O Solana Keychain fornece uma interface unificada para assinar transações Solana em múltiplos backends de gerenciamento de chaves. Use-o para integrar assinatura de nível empresarial nos seus serviços de backend.

Por que Keychain?

Interface Única: Um trait SolanaSigner funciona em todos os backends
Troque de Backends: Mude de provedores de gerenciamento de chaves sem reescrever código
Abstração de Custo Zero: Feature flags incluem apenas o que você precisa

Arquitetura

Linguagens: Rust + TypeScript
Trait: Interface unificada SolanaSigner
Backends: Memory, Vault, AWS KMS, GCP KMS, Privy, Turnkey, Fireblocks, CDP, Crossmint, Dfns, Openfort, Para
Compatibilidade: Compatível com @solana/kit e @solana/signers (TypeScript) | Compatível com solana-sdk e solana-sdk-v3 (Rust)

Backends Suportados

Backend	Caso de Uso	Rust	TypeScript
Memory	Desenvolvimento, testes	✓	✓
HashiCorp Vault	HSM auto-hospedado	✓	✓
AWS KMS	Nativo da nuvem (AWS)	✓	✓
GCP KMS	Nativo da nuvem (GCP)	✓	✓
Privy	Carteiras incorporadas	✓	✓
Turnkey	Não custodial	✓	✓
Fireblocks	MPC institucional	✓	✓
CDP	Coinbase Developer Platform	✓	✓
Crossmint	Carteiras gerenciadas Crossmint	✓	✓
Dfns	Infraestrutura de carteiras Dfns	✓	✓
Openfort	Carteiras incorporadas Openfort	✓	✓
Para	Carteiras MPC Para	✓	✓

Início Rápido

Rust

Instale o crate Rust:

cargo add solana-keychain

Uso básico:

use solana_keychain::{Signer, SolanaSigner};

// Create a signer from any backend
let signer = Signer::from_memory("base58_private_key")?;

// All signers share the same interface
let pubkey = signer.pubkey();
let signature = signer.sign_transaction(&mut tx).await?;

Guia Rust - Instalação completa e configuração de backend
Crates.io - Crate Rust

TypeScript

Instale o pacote TypeScript:

pnpm add @solana/keychain

Uso básico:

import { createKeychainSigner } from "@solana/keychain";
import { signTransactionWithSigners } from "@solana/signers";

// Create any signer via the unified factory
const signer = await createKeychainSigner({
  backend: "vault",
  vaultAddr: "https://vault.example.com:8200",
  vaultToken: "hvs.xxxxx",
  keyName: "my-solana-key",
  publicKey: "base58_public_key"
});

// Sign an already-compiled transaction
const signedTx = await signTransactionWithSigners(
  [signer],
  compiledTransaction
);

Guia TypeScript - @solana/keychain pacotes
Pacote npm - Pacote npm

Outros Recursos

Adicionar Signatários Personalizados - Integre novos backends
Lançamentos no GitHub - Histórico de lançamentos

Código-Fonte

Repositório GitHub

Desenvolvido e mantido pela Solana Foundation.

Licenciado sob MIT. Consulte LICENSE para detalhes.

Índice