Instalação

Comece a usar o Solana Pay instalando o SDK JavaScript e configurando seu ambiente de desenvolvimento. O SDK é independente de framework e funciona com qualquer ambiente JavaScript.

Requisitos do Sistema

Node.js: Versão 20 ou superior (necessário para suporte a Ed25519 crypto.subtle)
Gerenciador de Pacotes: pnpm, npm ou yarn
TypeScript: Versão 5+ (recomendado, mas não obrigatório)

Instalar o SDK do Solana Pay

Escolha seu gerenciador de pacotes preferido:

# Using pnpm (recommended)
pnpm add @solana/pay@beta @solana/kit

# Using npm
npm install @solana/pay@beta @solana/kit

# Using yarn
yarn add @solana/pay@beta @solana/kit

Dependências de Pares

As seguintes são dependências de pares do @solana/pay e devem ser instaladas juntamente com ele:

Pacote	Versão
`@solana/kit`	`^6.5.0`

Dependências Opcionais

Para criação e validação de transferências (transferências de SOL e tokens SPL), instale também:

pnpm add @solana-program/system @solana-program/token @solana-program/token-2022 @solana-program/memo

Para as fábricas de cliente (createMerchantClient, createWalletClient), instale também os plugins do kit:

pnpm add @solana/kit-plugin-rpc @solana/kit-plugin-payer @solana/kit-plugin-instruction-plan

Configuração do TypeScript

Se estiver usando TypeScript, certifique-se de que seu tsconfig.json inclui:

{
  "compilerOptions": {
    "module": "ESNext",
    "target": "ES2022",
    "lib": ["ES2022", "DOM", "DOM.Iterable"],
    "moduleResolution": "bundler",
    "resolveJsonModule": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  }
}

Configuração do Ambiente

Ambiente de Desenvolvimento

Configure as variáveis de ambiente para desenvolvimento:

# .env.local
SOLANA_RPC_URL=https://api.devnet.solana.com
SOLANA_NETWORK=devnet

Ambiente de Produção

Para produção, use os endpoints da mainnet:

# .env.production
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
SOLANA_NETWORK=mainnet-beta

Verificar Instalação

Crie um teste simples para verificar se tudo está funcionando:

// test-installation.ts
import { address } from "@solana/kit";
import { encodeURL } from "@solana/pay";

// Test creating a payment URL
const recipient = address("FvJ8k8HhXp4a3zQyFMZd4FvEqcYdYE7gSZWxrEBRfBsB");

const url = encodeURL({
  recipient,
  amount: 0.01,
  label: "Test Store",
  message: "Test payment"
});

console.log("Solana Pay URL:", url.toString());
// Output: solana:FvJ8k8Hh...?amount=0.01&label=Test%20Store&message=Test%20payment

Execute o teste:

npx tsx test-installation.ts

Você deverá ver uma URL válida do Solana Pay no console.

Problemas Comuns e Soluções

Erros de Resolução de Módulo

Se você encontrar erros como "Cannot resolve module '@solana/pay'":

Limpe o cache do seu gerenciador de pacotes:

# pnpm
pnpm store prune

# npm
npm cache clean --force

# yarn
yarn cache clean

Exclua node_modules e reinstale:
```
rm -rf node_modules
pnpm install
```

Erros de TypeScript

Se você encontrar erros de TypeScript:

Atualize para a versão mais recente do TypeScript (5+)
Certifique-se de que moduleResolution esteja definido como "bundler" ou "nodenext" no seu tsconfig.json

Próximos Passos

Agora que você tem o Solana Pay instalado, escolha seu caminho de integração:

Solicitações de Transferência - URLs de pagamento simples para transferências básicas
Solicitações de Transação - Fluxos de pagamento interativos
Integração de Código QR - Gere códigos QR para pagamentos móveis

Ferramentas de Desenvolvimento

Considere instalar estas ferramentas de desenvolvimento úteis:

# Solana CLI (for testing and key generation)
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

# Local validator for testing
solana-test-validator

Recursos

Repositório no GitHub - Código fonte e exemplos
Solana Cookbook - Receitas de desenvolvimento Solana

Índice