O que são carteiras inteligentes na Solana? Guia de comparação e implementação

O que é uma carteira inteligente?

Carteiras inteligentes são contas de programa executáveis que contêm código executável. Diferentemente das carteiras tradicionais, que são pares de chaves simples controlados por uma única chave privada, as carteiras inteligentes na Solana são implementadas como programas, com lógica e recursos especiais.  

Quais são os benefícios das carteiras inteligentes?

As carteiras inteligentes eliminam a necessidade de frases-semente e o risco de perda associado a elas. Em vez disso, permitem que os usuários designem um ou mais "signatários" ou chaves para controlar a carteira.

Essa flexibilidade possibilita opções de gerenciamento de chaves mais fáceis de usar, como biometria (por exemplo, Face ID, Touch ID ou chaves de acesso), além de esquemas de segurança avançados (por exemplo, multisig) ou controles de nível empresarial (por exemplo, uma chave de administrador no servidor).

As carteiras inteligentes viabilizam transações sem taxas ao permitir que os desenvolvedores patrocinem as taxas com SOL ou outros tokens SPL, como USDC, e as abstraiam facilmente do usuário final, proporcionando uma experiência mais familiar, semelhante à da web2.  

Isso significa que você pode criar aplicativos sem solicitações de aprovação de transações, sem frases-semente ou chaves privadas que possam ser perdidas e com segurança programável aplicada por programas (contratos inteligentes).

Carteiras inteligentes incorporadas vs. carteiras incorporadas vs. contas não executáveis

Casos de uso comuns de carteiras inteligentes

As carteiras inteligentes da Solana são úteis quando você precisa de arquiteturas de custódia flexíveis, como:

• Carteiras de tesouraria corporativa gerenciadas por vários funcionários
• Carteiras de agentes de IA em casos de uso de finanças agênticas, nos quais o proprietário do agente precisa de uma chave e o próprio agente precisa de outra
• Neobancos e aplicativos financeiros em que o usuário mantém a autocustódia, mas permite que o banco retire fundos (por exemplo, pagamentos recorrentes)

Uma característica importante dos signatários delegados é que o escopo deles pode ser limitado para restringir suas permissões sobre a carteira, como por meio de restrições de gastos ou de classes de ativos.

Como as carteiras inteligentes funcionam especificamente na Solana?

As carteiras inteligentes na Solana operam por meio de uma combinação de programas onchain e infraestrutura offchain, com algumas características exclusivas da Solana:

Arquitetura baseada em programas

Diferentemente das contas não executáveis (contas de dados), as carteiras inteligentes da Solana (ou contas de programa executáveis) geralmente são implementadas como programas onchain que controlam uma ou mais contas (PDAs).

Autorização de transações

Em vez de uma única chave privada, as carteiras inteligentes usam lógica de autenticação personalizada:

• Vários signatários podem ser exigidos (funcionalidade multisig)
• Vários métodos de autenticação podem ser aceitos (chaves, biometria, redes sociais)
• Bloqueios temporais e limites de gastos podem ser aplicados de forma programática

Delegação de contas

Os usuários podem delegar permissões específicas a diferentes endereços, o que oferece controle mais granular sobre o que cada chave ou dispositivo pode fazer.

Compatibilidade com transações versionadas

As carteiras inteligentes usam o formato padrão de transações versionadas da Solana.

O que é abstração de contas?

A abstração de contas (AA) permite que os desenvolvedores criem contas de contratos inteligentes personalizáveis que vão além das contas não executáveis vinculadas a um único par de chaves, possibilitando experiências de usuário mais flexíveis.

A AA permite lógica de validação personalizada, o que significa que as contas podem implementar recursos de segurança, como recuperação social, requisitos de multisig ou limites de gastos, sem depender das regras padrão da blockchain. 

O principal objetivo da AA é tornar a tecnologia blockchain invisível para os usuários, removendo barreiras técnicas, como taxas de transação e frases-semente, sem abrir mão dos benefícios da autocustódia.

Como funcionam as transações sem taxas na Solana?

A principal vantagem das carteiras inteligentes para transações sem taxas é que a abstração ocorre no nível da conta, sem exigir implementações específicas para cada dApp. Isso cria uma experiência mais fluida, na qual os usuários talvez nem percebam que existem taxas de transação.

Isso significa que os desenvolvedores podem implementar:

Abstração de taxas integrada

As carteiras inteligentes podem incorporar o patrocínio de taxas diretamente à sua arquitetura. O próprio contrato da carteira pode definir regras sobre quem paga as taxas e em quais circunstâncias.

Moeda flexível para taxas

Se você não quiser patrocinar as taxas de transação de um usuário, ele poderá pagar com SOL ou tokens como USDC ou USDT.

Mecanismos de aprovação

As carteiras inteligentes podem implementar lógica de verificação personalizada para determinar quando as transações patrocinadas são permitidas, como limitar a frequência ou restringi-las a aplicativos específicos.

Como adicionar carteiras inteligentes da Solana ao seu aplicativo com a Crossmint

Há muitas formas de integrar carteiras inteligentes ao seu aplicativo: no cliente, no servidor ou com arquiteturas de chave dupla para agentes de IA.

No tutorial abaixo, você aprenderá a implantar sua primeira carteira inteligente no servidor.

Pré-requisitos

Primeiro, crie uma conta de desenvolvedor no Console de Staging da Crossmint. 

Depois, acesse Settings > General no projeto e altere o tipo de carteira para “Smart Wallets”.

Você pode obter uma chave de API acessando Integrate > API Keys e selecionando “Create new key” na seção “Server-side keys”.

Na categoria Wallets API, selecione os seguintes escopos:

• wallets.create
• wallets.read
• wallets:signatures.create
• wallets:transactions.create
• wallets:transactions.read
• wallets:transactions.sign

Clique em “Create server key” para salvar a chave para a próxima etapa.

Crie sua primeira carteira inteligente

Crie um arquivo (por exemplo, createWallet.ts) e insira este código:

const apiKey = "YOUR_API_KEY";
const walletType = "solana-smart-wallet";
const adminSigner = {
    // In production, you may want to use an MPC solution, like
    // crossmint-managed MPC keys
    type: "solana-keypair",
};

async function createWallet() {
    const response = await fetch("https://staging.crossmint.com/api/2022-06-09/wallets", {
        method: "POST",
        headers: {
            "X-API-KEY": apiKey,
            "Content-Type": "application/json",
        },
        body: JSON.stringify({
            type: walletType,
            config: {
                adminSigner,
            },
        }),
    });

    return await response.json();
}

createWallet()
    .then((json) => console.log(json))
    .catch((err) => console.error(`error: ${err}`));

Antes de executá-lo, preencha YOUR_API_KEY com a chave obtida na etapa anterior.

Agora, execute o script:

npx tsx createWallet.ts

A API retornará uma resposta com os detalhes da sua nova carteira.

Salve o endereço da carteira, pois você o usará na próxima etapa.

Interaja com sua carteira

Agora que configuramos as carteiras em seu servidor, vamos interagir com elas.

Comece acessando o Crossmint Testnet USDXM Faucet e cole o endereço da carteira obtido na etapa anterior para receber USDXM de teste na Solana.

Agora que você tem alguns tokens, vamos verificar o saldo da carteira (checkBalance.ts):

const apiKey = "YOUR_API_KEY";
const walletAddress = "YOUR_WALLET_ADDRESS"; // From previous step
const tokens = ["sol", "usdc", "usdxm"]; // Tokens to fetch balances for
const chains = ["solana"]; // Chains to query balances from

async function getWalletBalance() {
    const url = new URL(`https://staging.crossmint.com/api/v1-alpha2/wallets/${walletAddress}/balances`);
    url.search = new URLSearchParams({
        tokens: tokens.join(','),
        chains: chains.join(',')
    }).toString();

    const response = await fetch(url, {
        method: "GET",
        headers: {
            "X-API-KEY": apiKey,
            "Content-Type": "application/json",
        },
    });

    return await response.json();
}

getWalletBalance()
    .then((json) => console.log(json))
    .catch((err) => console.error(`error: ${err}`));

Parabéns! Agora você tem carteiras inteligentes implantadas em seu servidor.

A partir daqui, você pode consultar a documentação para aprender a fazer sua primeira transação, adicionar signatários delegados e muito mais.

Conclusão

As carteiras inteligentes darão início a uma nova geração de aplicativos criados na Solana, aprimorando a integração inicial, a experiência do usuário, a segurança e a conformidade.

Na Crossmint, estamos entusiasmados em viabilizar uma ampla variedade de casos de uso, desde PI e programas de fidelidade até agentes de IA, com nossa API simples e ferramentas sem código para carteiras, pagamentos e tokenização, que podem escalar de forma confiável para milhões de usuários. Agora, com o lançamento das carteiras inteligentes incorporadas da Solana, também viabilizamos fintechs e aplicativos de agentes de IA.

Se quiser saber mais sobre como implementar carteiras inteligentes da Solana em seu projeto, entre em contato conosco. Teremos prazer em ajudar.

Recursos adicionais

• Documentação de carteiras — Crossmint
• Documentação de pagamentos — Crossmint
• Documentação de tokenização — Crossmint