Saltar para o conteúdo principal

3 posts marcados com "PYUSD"

Stablecoin PayPal USD

Ver todas as tags

Stablecoins atingem $ 311 B : USDC dobra , USDT mantém 59 % e o manual de reservas é reescrito

· 16 min de leitura
Dora Noda
Software Engineer

O mercado de stablecoins tornou-se discretamente um dos setores financeiros mais consequentes da década. Em abril de 2026, a capitalização total do mercado de stablecoins está acima de 311bilho~esaproximadamente50311 bilhões — aproximadamente 50 % superior ao valor de encerramento de 2024 e em uma trajetória que JPMorgan, Citi e a16z projetam que excederá 2 trilhões antes do fim deste ciclo.

Mas o número da manchete esconde a verdadeira história. Por trás do valor principal de 311bilho~es,asdina^micascompetitivasquedefiniramosetorpormeiadeˊcadaumduopoˊlioconfortaˊvelTetherCirclecomtodososoutroslutandopormigalhasesta~oruindo.AofertadeUSDCdaCircledobroupara311 bilhões, as dinâmicas competitivas que definiram o setor por meia década — um duopólio confortável Tether-Circle com todos os outros lutando por migalhas — estão ruindo. A oferta de USDC da Circle dobrou para 78 bilhões. A Tether mantém 59 % de participação de mercado, mas enfrenta desafiantes de todas as direções. E uma nova geração de stablecoins com rendimento, tokens de pagamento regulamentados e instrumentos emitidos por bancos está forçando cada emissor a reescrever o manual de reservas que impulsionou discretamente $ 33 trilhões em volume de liquidação em 2025.

Aqui está o que realmente está acontecendo, por que os números importam e como serão os próximos doze meses para a classe de ativos que está se tornando o encanamento financeiro da economia on-chain.

O Mercado de $ 311 B: O que está impulsionando o aumento

O setor de stablecoins encerrou o primeiro trimestre de 2026 com um recorde de 315bilho~esemcapitalizac\ca~odemercadototal,ultrapassando315 bilhões em capitalização de mercado total, ultrapassando 320 bilhões em meados de abril antes de se estabilizar em torno de 311bilho~esaˋmedidaquealgunsdosfluxosespeculativosrotacionaram.Paracolocarissoemperspectiva:todoomercadodestablecoinsvaliacercade311 bilhões à medida que alguns dos fluxos especulativos rotacionaram. Para colocar isso em perspectiva: todo o mercado de stablecoins valia cerca de 130 bilhões no início de 2024. Ele mais que dobrou em 16 meses.

Três forças estruturais estão realizando o trabalho.

Clareza regulatória federal. A Lei GENIUS, sancionada em julho de 2025, estabeleceu o primeiro arcabouço federal abrangente dos EUA para stablecoins de pagamento. Em março de 2026, o OCC publicou seu aviso de proposta de regulamentação, o FDIC estava finalizando os requisitos para Emissores de Stablecoins de Pagamento Permitidos (PPSIs) e o Tesouro propôs um regime de AML / sanções. Pela primeira vez, um banco nacional, uma associação de poupança federal ou uma instituição não bancária autorizada pode emitir stablecoins sob supervisão federal explícita. Este desbloqueio de legitimidade atraiu tesoureiros corporativos que passaram cinco anos esperando por cobertura regulatória.

Eficiência de capital on-chain. As stablecoins com rendimento — tokens que repassam o rendimento subjacente do Tesouro ou de basis-trade para os detentores — cresceram 15 vezes mais rápido do que o mercado geral de stablecoins nos seis meses que antecederam março de 2026. A categoria com rendimento representa agora 7,4 % do mercado total, com $ 22,7 bilhões em oferta, acima de menos de 2 % no ano anterior. Cada dólar estacionado em stablecoins com rendimento é um dólar que não ficou ocioso em um saldo de USDT ou USDC sem rendimento.

A tese da camada de liquidação está vencendo. O volume de transações de stablecoins reportado ultrapassou 33trilho~esem2025maisdoqueVisaeMastercardcombinadasparaaqueleano.Somenteemfevereirode2026,houveaproximadamente33 trilhões em 2025 — mais do que Visa e Mastercard combinadas para aquele ano. Somente em fevereiro de 2026, houve aproximadamente 1,8 trilhão em volume ajustado de stablecoins on-chain. As stablecoins não são mais o "estacionamento de traders" que eram em 2021. Elas são o trilho pelo qual fluem remessas, folhas de pagamento, liquidação B2B, FX e, cada vez mais, o comércio entre agentes.

A Fortaleza de $ 184 B da Tether: Dominância através da Distribuição

O USDT da Tether atingiu uma capitalização de mercado recorde de aproximadamente 188bilho~esem21deabrilde2026,ancorandoaparticipac\ca~odemercadodominantede59188 bilhões em 21 de abril de 2026, ancorando a participação de mercado dominante de 59 % da emissora. A atestação de dezembro de 2025 da empresa mostrou ativos totais de 192,9 bilhões contra 186,5bilho~esempassivos,deixando186,5 bilhões em passivos, deixando 6,3 bilhões em reservas excedentes — uma margem maior do que a Tether historicamente manteve.

A composição das reservas explica por que o USDT tem sido impossível de desalojar:

  • $ 141 bilhões em exposição ao Tesouro dos EUA (incluindo operações compromissadas reversas de um dia para o outro), tornando a Tether um dos maiores detentores individuais de dívida do governo dos EUA — maior do que a Alemanha, Coreia do Sul ou Emirados Árabes Unidos
  • $ 17,4 bilhões em ouro
  • $ 8,4 bilhões em bitcoin
  • $ 10 + bilhões em lucros líquidos em 2025, mais do que a maioria dos gestores de ativos de capital aberto

Mas o diferencial competitivo (moat) da Tether não são as reservas. É a distribuição. O USDT é o dólar padrão na Argentina, Turquia, Vietnã, Nigéria e em corredores de remessas que movimentam dezenas de bilhões de dólares por mês fora da infraestrutura bancária dos EUA. É a moeda de cotação em todas as principais corretoras centralizadas. É o que as mesas de balcão (OTC) asiáticas utilizam para liquidação. Nada disso muda da noite para o dia apenas porque existe um concorrente regulamentado.

É também por isso que a Tether está, segundo informações, explorando uma captação de capital de 15a15 a 20 bilhões com uma avaliação de 500bilho~esumnuˊmeroqueavaliariaaempresaacimadetodososbancosdosEUA,excetoJPMorgan,BankofAmericaeWellsFargo.Atese:oUSDTna~oeˊmaisapenasumemissordestablecoin.Eˊumsistemamonetaˊrioparalelocom500 bilhões — um número que avaliaria a empresa acima de todos os bancos dos EUA, exceto JPMorgan, Bank of America e Wells Fargo. A tese: o USDT não é mais apenas um emissor de stablecoin. É um sistema monetário paralelo com 10 bilhões em lucro anual, sem acionistas públicos e com uma demanda estrutural de mercados emergentes que não diminuirá.

A Arrancada de US$ 78 Bilhões da Circle: O Contrapeso Regulamentado

A capitalização de mercado da USDC da Circle ultrapassou US78,25bilho~esemmarc\code2026,apoˊsumauˊnicaemissa~o(mint)deUS 78,25 bilhões em março de 2026, após uma única emissão (mint) de US 600 milhões, e a Circle agora visa publicamente US150bilho~esemsuprimentocirculanteateˊasegundametadede2026.Issorepresentariaumaumentodeaproximadamente90 150 bilhões em suprimento circulante até a segunda metade de 2026. Isso representaria um aumento de aproximadamente 90% em relação à marca de US 112 bilhões em suprimento cumulativo registrada em 10 de abril de 2026.

Os números de 2025 são ainda mais impressionantes: a capitalização de mercado da USDC saltou 73% (para US75,12bilho~es)contraocrescimentode36 75,12 bilhões) contra o crescimento de 36% da USDT (para US 186,6 bilhões). A Circle superou o crescimento da Tether pelo segundo ano consecutivo — a primeira vez que um desafiante conseguiu tal feito na história das stablecoins.

O que mudou?

O IPO desbloqueou um tipo diferente de capital. A listagem do Circle Internet Group na NYSE sob o ticker CRCL deu à empresa uma moeda de mercado público para parcerias, M&A (fusões e aquisições) e flexibilidade de balanço que nenhum concorrente privado pode igualar.

O CCTP v3.0 tornou a USDC o dólar cross-chain padrão. O Protocolo de Transferência Cross-Chain (Cross-Chain Transfer Protocol) da Circle agora conecta nativamente a USDC em mais de 20 redes com finalidade de sub-segundo e sem risco de pool de liquidez. Todos os desenvolvedores que criam aplicações cross-chain usam a USDC por padrão, pois mover USDT exige bridges de terceiros, que possuem seu próprio histórico de hacks.

A distribuição empresarial alcançou o ritmo. O programa de liquidação de stablecoins da Visa, os corredores de remessa em USDC da MoneyGram, o checkout de pagamento com USDC da Stripe e a infraestrutura de cartões financiados por stablecoins da Mastercard agora alcançam, coletivamente, centenas de milhões de consumidores. Nenhuma dessas empresas teria integrado a USDT — a ambiguidade regulatória era um "não" definitivo para um comitê de risco da Fortune 500.

DePIN e agentes de IA descobriram a USDC. A taxa de crescimento anual composta projetada de 40% da Circle está sendo impulsionada menos por traders e mais pela demanda de máquinas. Redes DePIN pagam operadores de nós em USDC. Agentes de IA transacionando no protocolo x402 da Coinbase liquidam em USDC. A previsão da Solana Foundation de que 99% das transações on-chain serão impulsionadas por agentes dentro de dois anos é, fundamentalmente, uma tese de crescimento para a USDC.

A Corrida dos Emissores: Por Que o Duopólio Está Rachando

Durante a maior parte da história das stablecoins, "todos os outros" somados representavam menos de 5% do mercado. Isso está mudando agora — de forma lenta, mas visível.

**O PYUSD do PayPal atingiu US4,11bilho~esemcapitalizac\ca~odemercado,tendocrescidocercade8xemrelac\ca~oaoseupisodeaproximadamenteUS 4,11 bilhões em capitalização de mercado**, tendo crescido cerca de 8x em relação ao seu piso de aproximadamente US 500 milhões em meados de 2025. O PayPal expandiu o PYUSD por 13 redes em 2025 (Ethereum, Solana, Arbitrum, Stellar e outras) e lançou a disponibilidade em 70 mercados internacionais em março de 2026. Os pagamentos P2P financiados por PYUSD do PayPal e a integração com o Venmo oferecem um fosso de distribuição nativo que nenhum outro entrante possui — centenas de milhões de usuários que já confiam na marca para pagamentos.

**O RLUSD da Ripple está em cerca de US1,42bilha~o,apoˊstocarquaseUS 1,42 bilhão**, após tocar quase US 1,6 bilhão no início do ciclo. A estratégia da Ripple foca primeiro no institucional: o RLUSD está se tornando o colateral padrão dentro da Hidden Road, a corretora primária (prime brokerage) que a Ripple adquiriu por US$ 1,25 bilhão, o que dá ao RLUSD utilidade direta em liquidação transfronteiriça, câmbio (FX) e fluxos de corretagem primária que são amplamente invisíveis para as métricas de varejo.

Stablecoins com rendimento (yield-bearing) são o segmento que mais cresce. O USDe da Ethena, o USDY da Ondo, o USDM da Mountain Protocol, o USDG da Paxos e o próprio USYC da Circle estão acumulando coletivamente depósitos do Tesouro e rendimentos de arbitragem de base (basis-trade yield) a uma taxa que analistas do JPMorgan agora projetam que poderia capturar 50% da fatia total do mercado de stablecoins, caso obstáculos regulatórios não retardem a adoção. As principais histórias de crescimento durante a janela de seis meses encerrada em março de 2026 foram: USYC (+198%), USDG (+169%) e USDY (+91%).

Stablecoins emitidas por bancos são as próximas. Com o avanço da regulamentação da Lei GENIUS do OCC, JPMorgan, Citi, BNY Mellon e uma coalizão de bancos europeus (o consórcio Qivalis 12 para o lado do euro) estão todos preparando stablecoins de pagamento proprietárias para lançamento em 2026-2027. Os bancos têm feito lobby — por meio da ABA e outros grupos comerciais — para desacelerar a implementação da Lei GENIUS justamente porque desejam chegar ao mercado com seus próprios produtos antes que o framework consolide totalmente o modelo não bancário.

A Camada de Liquidação de US$ 33 Trilhões: Para Onde Vai o Volume

Se 2024 foi o ano em que as stablecoins ultrapassaram US$ 25 trilhões em volume de liquidação anual e superaram a Visa, 2026 é o ano em que a mistura de redes se inverteu.

A Solana registrou aproximadamente US650bilho~esemvolumeajustadodetransac\co~esdestablecoinsemfevereirode2026maisqueodobrodeseupicoanteriorcapturandoamaiorfatiaindividualdototalmensalcrosschaindeUS 650 bilhões em volume ajustado de transações de stablecoins em fevereiro de 2026 — mais que o dobro de seu pico anterior — capturando a maior fatia individual do total mensal cross-chain de US 1,8 trilhão. O volume de transferência de USDC na Solana tem excedido o da Ethereum desde o final de dezembro de 2025, apesar da Ethereum deter sete vezes mais suprimento de USDC (US47bilho~escontraUS 47 bilhões contra US 7 bilhões na Solana).

A economia é simples. Taxas de transação de menos de um centavo e finalidade de 400ms tornam a Solana o único local onde micropagamentos, remessas e transações de agentes de alta frequência são viáveis. Western Union e Bank of America adotaram publicamente a Solana para pilotos de liquidação com stablecoins. A Tron, histórica rainha das transferências de USDT de baixo custo em mercados emergentes, está perdendo mercado para a Solana pela primeira vez.

A Ethereum ainda domina em custódia, colateral DeFi e liquidação institucional — os casos de uso de alto valor e baixa frequência. Camadas 2 (Layer-2s) como Base, Arbitrum e Optimism estão absorvendo o meio do mercado. Mas a infraestrutura de alta frequência, onde 99% das futuras transações entre agentes residirão, pertence cada vez mais à Solana.

O Manual de Reservas Está Sendo Reescrito

O risco estrutural que se esconde sob o número de US$ 311 bilhões é o que a Web3Caff chamou de "lacuna de visibilidade de stablecoins". As reservas são tipicamente atestadas mensalmente. Os fundos se movem na velocidade das máquinas. Agentes de IA agora tratam USDC e USDT como equivalentes a caixa, mas os instantâneos de suas reservas têm semanas de idade. Em um cenário de estresse — um deslocamento do mercado do Tesouro, uma falha de um parceiro bancário, um congelamento impulsionado por sanções — essa lacuna poderia desencadear uma desvinculação (de-pegging) reflexiva em velocidades que o episódio SVB-USDC de 2023 apenas sugeriu.

Os requisitos de reserva, capital e liquidez da Lei GENIUS são projetados para fechar essa lacuna, mas a implementação se estende até 2027. Até lá, cada requerente de PPSI está essencialmente competindo em três vetores:

  1. Transparência de reservas — atestações diárias, prova de reservas (proof-of-reserves) on-chain, auditorias de terceiros
  2. Profundidade de distribuição — listagens em corretoras, integrações de pagamento, disponibilidade cross-chain
  3. Economia de rendimento — quanto do rendimento do Tesouro subjacente é repassado aos detentores em comparação ao que é retido pelo emissor

A Tether vence no item # 2 por uma margem enorme. A Circle vence no # 1 e está se aproximando no # 2. Os novos entrantes que oferecem rendimento vencem no # 3 por definição, mas carecem de escala para competir nos outros. PayPal e Ripple estão comprando o # 2 com marca e aquisição. Os produtos emitidos por bancos que chegarão no final de 2026 competirão em um quarto vetor — o respaldo implícito do FDIC — que nenhum dos incumbentes pode igualar.

O Que Vem a Seguir

O caminho para US$ 1 trilhão em capitalização de mercado de stablecoins, que o Standard Chartered projeta para o final de 2027, passa por três terrenos contestados:

  • Licenciamento federal. O primeiro lote de PPSIs não bancários autorizados pelo OCC — provavelmente Circle, Paxos e um ou dois outros — surgirá em meados ou final de 2026 com fossos regulatórios que o PYUSD, RLUSD e tokens com rendimento não regulamentados não podem replicar facilmente.
  • Trilhos da economia de agentes. Se a previsão da Fundação Solana de 99 % de transações por agentes chegar perto da realidade, os emissores de stablecoins integrados em SDKs de agentes (Coinbase x402, Skyfire KYAPay, Nevermined) crescerão a taxas que em nada se assemelham às curvas de crescimento financeiro tradicionais.
  • Demanda de dólares em mercados emergentes. O domínio da Tether na Argentina, Turquia, Vietnã e Nigéria é a maior barreira isolada para a dominância do USDC. Nem a Lei GENIUS, nem o capital de IPO, nem as integrações empresariais mudam a situação em mercados onde o USDT já é o dólar de fato.

A corrida das stablecoins em 2026 não é mais sobre "quem vence" — é sobre "quantos vencedores coexistem e em que escala". Um mercado de US$ 311 bilhões com três vetores de crescimento estrutural (regulatório, rendimento, demanda de agentes) e pelo menos oito emissores credíveis é um mercado que se fragmenta antes de se consolidar. A próxima etapa de crescimento não será medida em manchetes de capitalização de mercado, mas em quais emissores conseguem se integrar à infraestrutura de pagamento, liquidação e agentes que não será desfeita uma vez instalada.

O dólar está se tornando on-chain. A única questão restante é de quem será esse dólar.

A BlockEden.xyz alimenta a infraestrutura RPC de alto rendimento por trás de aplicações de stablecoins no Ethereum, Solana, Sui, Aptos e em mais de 15 outras redes. Quer você esteja construindo um trilho de pagamento, um protocolo de rendimento ou uma camada de liquidação impulsionada por agentes, explore nosso marketplace de APIs para uma infraestrutura de nível de produção construída para a economia do dólar on-chain.

Fontes

PYUSD Atinge Silenciosamente US$ 4,5 Bilhões: Como a Stablecoin do PayPal Provou que a Distribuição Vence a Tecnologia

· 15 min de leitura
Dora Noda
Software Engineer

Enquanto o Twitter cripto passou o último ano discutindo sobre redes modulares vs. monolíticas e qual stablecoin com rendimento destronaria o Tether, o token de dólar de crescimento mais rápido no mercado fez algo quase embaraçosamente simples. Ele se conectou a um botão de checkout que 400 milhões de pessoas já sabiam usar.

O PayPal USD (PYUSD) ultrapassou US$ 4,5 bilhões em capitalização de mercado em abril de 2026, superando o USDS da Sky para se tornar a quarta maior stablecoin do mundo. Sua oferta expandiu 16,66 % nos últimos 30 dias, enquanto o USDT da Tether cresceu apenas 1,02 %. E ele chegou lá sem airdrop, sem campanha de pontos, sem rendimento DeFi de dois dígitos e quase sem nenhuma presença no Twitter cripto.

A história do PYUSD é o estudo de caso mais claro até agora para uma tese que os construtores nativos de cripto passaram anos tentando refutar: em stablecoins, a distribuição vence a tecnologia. Sempre.

PYUSD no Solana: O Guia Prático de Integração (com RPC da BlockEden.xyz)

· 9 min de leitura
Dora Noda
Software Engineer

PayPal USD (PYUSD) chegou ao Solana, marcando um marco significativo para pagamentos digitais. Este guia fornece um passo‑a‑passo direto e focado em produção para engenheiros que desejam integrar o PYUSD em carteiras, dApps e plataformas de comércio no Solana.

Todos os exemplos utilizam código atualizado e compatível com Token-2022 e são projetados para funcionar perfeitamente com os endpoints RPC de baixa latência da BlockEden.xyz.

TL;DR

  • O que: PayPal USD (PYUSD) agora é um token SPL nativo Token-2022 no Solana, oferecendo liquidação rápida e com baixas taxas para um stablecoin reconhecido globalmente.
  • Parâmetros principais: Mint 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo, decimais 6 e programa de token Token-2022.
  • Conjunto de recursos: Utiliza as Extensões de Token do Solana (Token-2022). Possui um Transfer Hook inicializado, mas atualmente inativo (programa nulo), além de capacidades de transferência confidencial e outras extensões.
  • Cross‑chain: Uma integração oficial com LayerZero permite que o PYUSD se mova entre Ethereum e Solana via um mecanismo seguro de queima‑e‑mint, contornando pontes tradicionais.
  • Ação: Use este guia como um modelo pronto para adicionar suporte ao PYUSD em sua aplicação com o RPC confiável da BlockEden.xyz.

Por que o PYUSD no Solana é importante

A combinação da marca PayPal com o desempenho do Solana cria uma nova via poderosa para dólares digitais.

  1. Confiança do consumidor encontra UX cripto: O PYUSD é emitido pela empresa regulada Paxos e está profundamente integrado ao PayPal e ao Venmo. Isso oferece ao usuário um ativo familiar. Eles podem manter um único saldo em PYUSD e escolher retirar para uma carteira externa tanto no Ethereum quanto no Solana, abstraindo a complexidade das cadeias.
  2. Infraestrutura pronta para pagamentos: A arquitetura do Solana fornece finalização de transação em subsegundos e taxas que são frações de centavo. O PYUSD adiciona uma unidade de conta estável e reconhecível sobre essa rede de liquidação eficiente, tornando‑o ideal para pagamentos, comércio e remessas.
  3. Controles de nível institucional: Ao ser lançado como token Token-2022, o PYUSD pode utilizar extensões nativas para recursos como transferências confidenciais, metadados ricos e delegado permanente. Isso permite conformidade avançada e funcionalidade sem a necessidade de contratos inteligentes personalizados e difíceis de auditar.

O essencial absoluto (fixe isso)

Antes de escrever uma única linha de código, tenha esses parâmetros bloqueados. Sempre verifique o endereço da mint em um explorador confiável para evitar interagir com tokens fraudulentos.

  • Mint (Mainnet): 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo
  • Decimais: 6 (significa 1 PYUSD = 1.000.000 unidades base)
  • Programa de Token: Token-2022 (Program ID: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb)
  • Extensões de Token usadas (na mint):
    • Metadados e Ponte de Metadados
    • Delegado Permanente
    • Transfer Hook (inicializado com programa nulo)
    • Configuração de Transferência Confidencial

Você pode verificar tudo isso no Explorador Solana. O explorador mostrará claramente o endereço oficial da mint e as extensões habilitadas.

Configurando seu projeto

Vamos preparar o ambiente. Você precisará das bibliotecas mais recentes de Solana web3 e SPL token para garantir compatibilidade total com Token-2022.

1. Bibliotecas

Instale os pacotes necessários via npm.

npm i @solana/web3.js @solana/spl-token

2. Conexão RPC

Aponte sua aplicação para a URL RPC do Solana Mainnet da BlockEden.xyz. Em produção, variáveis de ambiente são obrigatórias.

// package.json
// npm i @solana/web3.js @solana/spl-token

import { Connection, Keypair, PublicKey } from "@solana/web3.js";
import {
TOKEN_2022_PROGRAM_ID,
getMint,
getOrCreateAssociatedTokenAccount,
getAssociatedTokenAddress,
createTransferCheckedInstruction,
} from "@solana/spl-token";

// Use sua URL RPC da BlockEden.xyz obtida no painel
const RPC_ENDPOINT =
process.env.SOLANA_RPC_URL ??
"[https://your-blockeden-solana-mainnet-endpoint.com](https://your-blockeden-solana-mainnet-endpoint.com)";
export const connection = new Connection(RPC_ENDPOINT, "confirmed");

// PYUSD (mainnet)
export const PYUSD_MINT = new PublicKey(
"2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo",
);

Lendo dados da Mint PYUSD

Primeiro, confirme programaticamente as propriedades da mint PYUSD. Esta é uma etapa crucial para garantir que suas constantes estejam corretas e para buscar detalhes como o suprimento total.

// Confirme as informações da mint PYUSD via APIs Token-2022
const mintInfo = await getMint(
connection,
PYUSD_MINT,
"confirmed",
TOKEN_2022_PROGRAM_ID, // Especifique o ID do programa
);

console.log({
supply: mintInfo.supply.toString(),
decimals: mintInfo.decimals, // Espera 6
isInitialized: mintInfo.isInitialized,
});

Observe que passamos explicitamente TOKEN_2022_PROGRAM_ID. Essa é a fonte mais comum de erros ao trabalhar com Extensões de Token.

Criar ou buscar Contas de Token Associadas (ATAs)

Contas de Token Associadas para tokens Token-2022 devem ser derivadas usando o ID do programa Token-2022. Se usar o TOKEN_PROGRAM_ID legado, as transações falharão com erro “incorrect program id”.

// Pagador e proprietário da nova ATA. Substitua pela lógica da sua carteira.
const owner = Keypair.generate();

// Crie ou busque a ATA PYUSD do proprietário (compatível com Token-2022)
const ownerAta = await getOrCreateAssociatedTokenAccount(
connection,
owner, // Pagador pela criação
PYUSD_MINT, // Mint
owner.publicKey, // Proprietário da ATA
false, // allowOwnerOffCurve
"confirmed",
undefined, // options
TOKEN_2022_PROGRAM_ID, // <-- IMPORTANTE: Use o ID do programa Token-2022
);

console.log("Owner PYUSD ATA:", ownerAta.address.toBase58());

Verificando saldos de PYUSD

Para consultar o saldo de PYUSD de um usuário, consulte sua ATA, lembrando sempre de especificar o ID do programa correto.

Usando @solana/spl-token

import { getAccount } from "@solana/spl-token";

const accountInfo = await getAccount(
connection,
ownerAta.address,
"confirmed",
TOKEN_2022_PROGRAM_ID,
);

const balance = Number(accountInfo.amount) / 10 ** mintInfo.decimals; // decimais = 6
console.log("PYUSD balance:", balance);

Usando JSON‑RPC direto (curl)

Também é possível listar todas as contas de token de um proprietário e filtrar pelo ID do programa Token-2022.

curl -X POST "$SOLANA_RPC_URL" -H 'content-type: application/json' -d '{
"jsonrpc":"2.0",
"id":1,
"method":"getTokenAccountsByOwner",
"params":[
"<OWNER_PUBLIC_KEY>",
{ "programId":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb" },
{ "encoding":"jsonParsed" }
]
}'

Transferindo PYUSD (Usuário‑para‑Usuário)

A regra de ouro para transferir qualquer ativo Token-2022 é usar createTransferCheckedInstruction. Essa instrução inclui os decimais do token, prevenindo vulnerabilidades relacionadas a casas decimais.

Aqui está uma função completa e reutilizável para transferir PYUSD.

import { Transaction } from '@solana/web3.js';

async function transferPyusd({
fromWallet, // Keypair do remetente
toPubkey, // PublicKey do destinatário
uiAmount, // Valor em PYUSD, ex.: 1.25
}: {
fromWallet: Keypair;
toPubkey: PublicKey;
uiAmount: number;
}) {
const decimals = 6; // De mintInfo.decimals
const rawAmount = BigInt(Math.round(uiAmount * (10 ** decimals)));

// Obtenha o endereço ATA do remetente
const fromAta = await getAssociatedTokenAddress(
PYUSD_MINT,
fromWallet.publicKey,
false,
TOKEN_2022_PROGRAM_ID
);

// Garanta que a ATA do destinatário exista para Token-2022
const toAta = await getOrCreateAssociatedTokenAccount(
connection,
fromWallet, // Pagador
PYUSD_MINT,
toPubkey,
false,
'confirmed',
undefined,
TOKEN_2022_PROGRAM_ID
);

const transferInstruction = createTransferCheckedInstruction(
fromAta, // ATA de origem
PYUSD_MINT, // Mint
toAta.address, // ATA de destino
fromWallet.publicKey, // Dono da ATA de origem
rawAmount, // Valor em unidades base
decimals, // Decimais
[], // Signatários multisig
TOKEN_2022_PROGRAM_ID // <-- IMPORTANTE
);

const transaction = new Transaction().add(transferInstruction);

// Defina blockhash recente e pagador da taxa
transaction.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
transaction.feePayer = fromWallet.publicKey;

const signature = await connection.sendTransaction(transaction, [fromWallet]);
await connection.confirmTransaction(signature, 'confirmed');

console.log('Transação bem‑sucedida com assinatura:', signature);
return signature;
}

Nota sobre o Transfer Hook: A mint do PYUSD inicializa a extensão Transfer Hook, mas define seu programa como null. Isso significa que transferências padrão funcionam sem contas ou lógica adicionais. Caso a PayPal/Paxos ative o hook no futuro, eles atualizarão a mint para apontar para um novo programa, e sua integração precisará passar as contas extras exigidas pela nova interface.

Teste rápido com Solana CLI

Para um teste manual rápido via linha de comando, use spl-token com o ID de programa correto.

# Certifique-se de que sua CLI esteja apontando para mainnet e que seu keypair esteja financiado.
# Transfira 1.00 PYUSD para um destinatário.
spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb \
transfer 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo 1.00 <RECIPIENT_PUBKEY> \
--fund-recipient --allow-unfunded-recipient

PYUSD Cross‑Chain (Ethereum ↔ Solana)

A PayPal implementou uma funcionalidade oficial cross‑chain usando LayerZero. Em vez de depender de pontes de terceiros arriscadas, este é um processo nativo de queima‑e‑mint: o PYUSD é queimado na cadeia de origem (por exemplo, Ethereum) e uma quantidade equivalente é mintada na cadeia de destino (Solana). Isso elimina riscos específicos de pontes e slippage.

Você pode encontrar o tutorial completo e os parâmetros na documentação oficial do PayPal Developer.

Teste com Faucets

Para desenvolvimento e testes, não use ativos da mainnet. Utilize os faucets oficiais:

  • Faucet Paxos PYUSD: Para obter tokens PYUSD de teste.
  • Faucet Solana: Para obter SOL de devnet/testnet para taxas de transação.

Armadilhas comuns (e correções)

  1. ID de programa errado: Problema: Transações falham com incorrect program id for instruction. Correção: Passe explicitamente TOKEN_2022_PROGRAM_ID para todas as funções auxiliares do spl-token (getOrCreateAssociatedTokenAccount, getAccount, createTransferCheckedInstruction, etc.).
  2. Mint errada ou ativos falsificados: Problema: Sua aplicação interage com um token PYUSD falso. Correção: Codifique e verifique o endereço oficial da mint: 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo. Use um explorador que avise sobre mints não canônicas.
  3. Descompasso de decimais: Problema: Enviar 1 PYUSD na verdade envia 0.000001 PYUSD. Correção: Sempre converta valores de UI para valores brutos multiplicando por 10^6. Busque programaticamente os decimais da mint para garantir.
  4. Suposições sobre Hook: Problema: Você implementou lógica complexa para um hook de transferência que ainda não está ativo. Correção: Verifique os dados de extensão da mint. Atualmente, o hook do PYUSD é nulo. Construa seu sistema para adaptar-se caso o programa do hook seja habilitado no futuro.

Checklist de produção para PYUSD + BlockEden.xyz

Ao migrar para produção, garanta que sua infraestrutura seja robusta.

  • RPC: Use um endpoint BlockEden.xyz de alta disponibilidade. Use o compromisso confirmed para UX responsiva e consulte com finalized para operações críticas.
  • Segurança das chaves: Armazene as Keypair em cofres seguros (por exemplo, HSM ou serviços de gerenciamento de segredos).
  • Monitoramento: Registre métricas de latência e taxa de erro dos endpoints RPC.
  • Conformidade: Mantenha logs de auditoria de todas as transações de pagamento.

Pronto para construir? Pegue seu endpoint de alto desempenho da BlockEden.xyz RPC e comece a integrar o futuro dos pagamentos hoje.