
UX segura e sem atrito: a stack tecnológica que integra milhões de usuários à Solana
Um guia para desenvolvedores sobre como usar Privy e Helius para carteiras integradas, transações sem taxas de gas e onboarding sem atrito.
Hoje, a maioria dos aplicativos de cripto voltados ao consumidor depende de carteiras externas, obrigando os usuários a gerenciar frases-semente, passar por vários redirecionamentos e aprovar manualmente cada transação.
Para o usuário comum que não conhece blockchain, isso é inviável. Frases-semente, taxas de gas e pop-ups de carteiras não apenas geram atrito — eles causam abandono. Com isso, aplicativos com ótimos produtos perdem usuários antes mesmo que eles comecem.
Não precisa ser assim.
Neste guia, você aprenderá a criar experiências onchain fluidas na Solana usando Privy e Helius, com transações sem taxas de gas, carteiras integradas e negociações instantâneas com latência de < 20 ms.
Vamos abordar como:
- Provisionar carteiras integradas autocustodiais com logins simples (e-mail, redes sociais, SMS), além de oferecer suporte a carteiras externas como Phantom, Solflare, Backpack e outras — tudo por meio do SDK da Privy
- Habilitar transações sem taxas de gas patrocinando taxas por meio de carteiras seguras
- Integrar on-ramps fiat como MoonPay ou Coinbase Pay à sua UI
- Fazer o bridging nativo de liquidez para a Solana sem atrito
- Criar para dispositivos móveis com uma UX onchain fluida que oferece a mesma facilidade da Web2
Vamos entender o que é necessário para integrar os próximos milhões de usuários por meio do seu aplicativo na Solana.
Onboarding em cripto na prática: exemplos de DeFi e aplicativos de consumo
Um onboarding fluido não é apenas um diferencial; é um multiplicador de crescimento. Aplicativos que usam carteiras integradas podem alcançar uma retenção mensal de usuários superior a 40%, especialmente quando atendem usuários novos no universo cripto.
Para a maioria dos consumidores, conceitos nativos de cripto como gas, slippage, taxas de prioridade e gorjetas são desconhecidos e complexos.
Para reter usuários, os aplicativos precisam tornar o onboarding acessível. Isso significa permitir que os usuários interajam com stablecoins como USDC ou cubram taxas de gas por meio de transações patrocinadas.
O objetivo é simples: permitir que os usuários assinem, façam swaps e staking sem precisar aprender como as criptomoedas funcionam.
Pump.fun — Plataforma de lançamento de tokens
A Pump.fun é uma das plataformas de negociação que mais crescem na Solana. Ela combina carteiras integradas com transações sem taxas de gas para oferecer negociações instantâneas com um único toque, sem pop-ups, aprovações ou troca de carteira.
Criada inicialmente para traders de alta frequência, a experiência Advanced se mostrou tão eficaz que foi disponibilizada para todos os usuários.
Hoje, qualquer pessoa pode lançar um token e começar a negociar pelo celular em segundos. Alguns usuários chegaram a movimentar milhões de dólares por meio de carteiras fornecidas pela Privy, tudo isso sem sair do aplicativo móvel.
Jupiter — Agregador de DEX
A experiência Quick Account da Jupiter mostra o potencial de uma negociação fluida. Cada usuário, seja acessando pela Phantom, Solflare, Backpack ou até mesmo por e-mail ou X, interage com a infraestrutura de carteiras integradas da Privy nos bastidores.
Essa configuração permite negociações instantâneas sem exigir a assinatura de transações, oferecendo sempre uma execução sem atrito e pelo melhor preço.
Quando estiverem prontos, os usuários podem exportar suas chaves para carteiras externas, mantendo controle total e evitando a dependência de um fornecedor.
Moonwalk — Aplicativo móvel walk-to-earn
O Moonwalk oferece uma experiência de onboarding móvel sem atrito ao permitir que os usuários se cadastrem por e-mail, redes sociais ou SMS, como em qualquer outro aplicativo Web2 voltado ao consumidor.
Nos bastidores, cada cadastro provisiona automaticamente uma carteira integrada totalmente funcional usando a Privy. Os usuários não precisam se preocupar com frases-semente, extensões de carteira ou qualquer configuração específica de cripto.
Em vez disso, eles simplesmente começam a caminhar e ganhar, sem sequer perceber que estão onchain.
Como criar uma UX onchain fluida: financiamento nativo de contas
Criar carteiras integradas nos bastidores é apenas o começo. Para oferecer uma experiência realmente fluida no aplicativo, os desenvolvedores também precisam lidar com o financiamento de contas e a liquidez entre blockchains, duas das causas mais comuns de abandono de usuários.
On-ramps integrados
Os melhores aplicativos de consumo eliminam o atrito em todas as etapas, inclusive quando o usuário precisa adicionar fundos à sua carteira.
Ao integrar on-ramps fiat diretamente à experiência do aplicativo, os usuários podem comprar SOL ou USDC sem sair da interface.
O SDK da Privy facilita a integração de provedores de on-ramp como MoonPay e Coinbase Pay, permitindo a compra nativa de ativos da Solana com apenas alguns cliques.
Bridging nativo
Outro recurso essencial é o bridging nativo de liquidez. Se a carteira Solana de um usuário não tiver saldo suficiente, os desenvolvedores podem configurar suas carteiras Privy para transferir saldos de uma blockchain EVM como Ethereum, Base ou Polygon.
Isso transforma seu aplicativo em um destino de liquidez, trazendo ativos de onde seus usuários já estão diretamente para a sua experiência na Solana. Sem trocar de aplicativo. Sem copiar endereços de carteira. Apenas uma transferência de valor fluida entre blockchains.
Como configurar transações sem taxas de gas com Privy e Helius
Além do financiamento de contas e do bridging entre blockchains, as carteiras da Privy oferecem gerenciamento seguro de chaves e foram desenvolvidas especificamente para configurações de pagador de taxas, ao contrário dos pares de chaves tradicionais.
1. Crie uma carteira gerenciada
Para configurar transações sem taxas de gas para seus usuários, você precisará provisionar uma carteira gerenciada que atue como a “pagadora de taxas”.
Essa carteira cobrirá as taxas de gas em nome dos usuários, oferecendo a eles uma experiência fluida e sem custos.
Depois de habilitar as carteiras gerenciadas no painel da Privy, você poderá criar uma programaticamente no lado do servidor usando o SDK Node.js da Privy.
Usando o SDK NodeJS da Privy:
import { PrivyClient } from '@privy-io/server-sdk';
// Initialize the Privy client
const privy = new PrivyClient({
apiKey: process.env.PRIVY_API_KEY
});
// Create a new Solana managed wallet
async function createFeePayerWallet() {
const { id, address, chainType } = await privy.walletApi.create({
chainType: 'solana',
policyIds: ['optional_policy_id'],
idempotencyKey: 'unique_request_identifier'
});
console.log(`Created fee payer wallet with ID: ${id}`);
console.log(`Wallet address: ${address}`);
return { id, address };
}
// Make sure to fund this wallet with SOL to cover transaction fees
O ID e o endereço da carteira serão usados nas etapas seguintes para patrocinar transações.
2. Implemente transações patrocinadas
Depois que a carteira gerenciada estiver configurada e financiada, você poderá começar a habilitar transações sem taxas de gas para os usuários.
Quando um usuário se autentica, a Privy provisiona uma carteira integrada vinculada às suas credenciais de login. Os usuários assinam as transações normalmente, mas, em vez de enviá-las à blockchain, a transação é encaminhada ao seu backend, onde sua carteira gerenciada a assina e envia por eles.
Este guia se concentra nas carteiras integradas da Privy. No entanto, o padrão de transações patrocinadas funciona com qualquer carteira Solana. O usuário assina a transação, enquanto seu servidor cobre as taxas de gas e transmite a transação para a rede.
Essa configuração viabiliza uma experiência fluida e, ao mesmo tempo, mantém os usuários no controle total de suas chaves.
Implementação no lado do cliente (React com o SDK da Privy)
import { useSolanaWallets } from '@privy-io/react-auth/solana';
import {
TransactionMessage,
PublicKey,
VersionedTransaction,
Connection
} from '@solana/web3.js';
async function sendGaslessTransaction(instructions) {
// Get user's embedded wallet
const { wallets } = useSolanaWallets();
const embeddedWallet = wallets.find(wallet =>
wallet.walletClientType === 'privy'
);
if (!embeddedWallet) {
throw new Error('No embedded wallet found');
}
// Connect to Solana via Helius for better performance
const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=YOUR_HELIUS_API_KEY');
const { blockhash } = await connection.getLatestBlockhash();
// Set your managed wallet as fee payer
const feePayerAddress = 'YOUR_PRIVY_SERVER_WALLET_ADDRESS';
// Build transaction with managed wallet as payer
const message = new TransactionMessage({
payerKey: new PublicKey(feePayerAddress),
recentBlockhash: blockhash,
instructions
}).compileToV0Message();
const transaction = new VersionedTransaction(message);
// Have user sign the transaction
const provider = await embeddedWallet.getProvider();
const serializedMessage = Buffer.from(
transaction.message.serialize()
).toString('base64');
const { signature } = await provider.request({
method: 'signMessage',
params: { message: serializedMessage }
});
// Add user signature
const userSignature = Buffer.from(signature, 'base64');
transaction.addSignature(
new PublicKey(embeddedWallet.address),
userSignature
);
// Send to your backend for fee payer signature
const serializedTx = Buffer.from(
transaction.serialize()
).toString('base64');
const response = await fetch('/api/sponsor-transaction', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ transaction: serializedTx })
});
const { transactionHash } = await response.json();
return transactionHash;
}
Por fim, a transação parcialmente assinada é enviada do cliente para o seu backend, onde é verificada, assinada pela carteira gerenciada e transmitida para a rede Solana.
Implementação no backend (rota de API do Next.js)
// pages/api/sponsor-transaction.js
import { VersionedTransaction } from '@solana/web3.js';
import { PrivyClient } from '@privy-io/server-sdk';
// Initialize Privy SDK
const privy = new PrivyClient({
apiKey: process.env.PRIVY_API_KEY
});
// For App Router (Next.js 13+)
export async function POST(request) {
try {
const { transaction: serializedTx } = await request.json();
// Deserialize the transaction to verify it (optional)
const txBuffer = Buffer.from(serializedTx, 'base64');
const transaction = VersionedTransaction.deserialize(txBuffer);
// Verify the transaction (check fee payer, validate against policies)
// ...verification logic here...
// Sign AND send with your Privy managed wallet in one step
const serverWalletId = process.env.PRIVY_SERVER_WALLET_ID;
const { hash } = await privy.walletApi.solana.signAndSendTransaction({
walletId: serverWalletId,
caip2: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1', // Mainnet
transaction: serializedTx,
rpcUrl: 'https://mainnet.helius-rpc.com/?api-key=YOUR_HELIUS_API_KEY',
options: {
maxRetries: 5,
skipPreflight: true
}
});
return Response.json({
transactionHash: hash,
message: 'Transaction sent successfully'
}, { status: 200 });
} catch (error) {
console.error('Error processing transaction:', error);
return Response.json({
error: 'Failed to process transaction',
details: error.message
}, { status: 500 });
}
}
Ao combinar as carteiras seguras da Privy com a infraestrutura otimizada de transações da Helius, você pode oferecer aos seus usuários uma experiência fluida e sem taxas de gas, sem comprometer a confiabilidade ou a flexibilidade.
A stack mais flexível para criar experiências fluidas em aplicativos
O SDK modular da Privy, junto com os nós RPC de alto desempenho da Helius, oferece aos desenvolvedores uma base avançada e flexível para criar aplicativos de excelência na Solana.
Você pode começar com uma API de carteira de baixo nível e usar sua própria stack de autenticação ou usar a Privy para autenticação e outros recursos avançados, como autenticação multifator (MFA), on-ramps integrados ou bridging nativo. Em qualquer cenário, a stack da Privy acompanha as necessidades do seu produto.
Recursos adicionais
Artigos relacionados
Assine a Helius
Acompanhe as novidades mais recentes do desenvolvimento Solana e receba atualizações quando publicarmos


