Solana · SPL Token

Integre PIXC com uma identidade única.

Este guia é a fonte técnica pública para carteiras, jogos, lojas e aplicativos reconhecerem e transferirem PixCoin sem guardar chaves do usuário.

Começar pela identidadeUsar o prompt para IA
Identidade canônica

Confira pelo mint, nunca apenas pelo nome.

Rede
Solana mainnet
Mint
AJAb19vFHfZg1Bs4eYkL2NXjHeuRXNPG8wry8p1f26fq
Casas decimais
2 casas decimais
Token Program
TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
Metadados JSON
https://wordfinance.org/assets/pixc-token-metadata.json
Transparência
https://wordfinance.org/api/pixc/transparency
Referência econômica: a política declarada pela WordFinance usa 1 PIXC para R$1 elegível confirmado na emissão primária. O preço em DEX ou corretora é secundário e pode variar.
Carteiras e aplicativos

Fluxo mínimo de integração

1. Reconhecer

Cadastre o mint oficial, 2 decimais, nome, símbolo e a imagem hospedada no domínio WordFinance.

2. Receber

Derive ou crie a Associated Token Account do usuário para o mint PIXC. O endereço principal da carteira não deve ser confundido com o mint.

3. Enviar

Monte uma instrução SPL TransferChecked, mostre mint, quantidade e destino e solicite a assinatura na carteira.

4. Confirmar

Consulte a Solana, aguarde estado confirmado ou finalizado e mostre a assinatura no explorador.

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

export const PIXC = {
  mint: new PublicKey('AJAb19vFHfZg1Bs4eYkL2NXjHeuRXNPG8wry8p1f26fq'),
  decimals: 2,
  metadata: 'https://wordfinance.org/assets/pixc-token-metadata.json',
  transparency: 'https://wordfinance.org/api/pixc/transparency'
};

// Use getAssociatedTokenAddress para localizar a conta PIXC do usuário.
// Use createTransferCheckedInstruction e peça assinatura à carteira.
// Nunca envie seed, private key ou PIN para o seu servidor.
Pagamentos

Como aceitar PIXC sem creditar duas vezes

  1. O backend cria um pedido persistido com identificador único, valor esperado, carteira de destino e expiração.
  2. O cliente deriva a conta PIXC do comprador e do recebedor.
  3. O cliente monta TransferChecked e inclui uma referência exclusiva quando o produto utilizar memo.
  4. A carteira mostra rede, ativo, valor e destino antes de assinar.
  5. O cliente envia somente a assinatura pública ao backend.
  6. O backend valida mint, origem vinculada, destino, valor, horário e confirmação on-chain.
  7. A assinatura da transação vira chave idempotente e nunca pode liberar dois pedidos.
  8. Falhas ambíguas ficam em revisão; não presuma pagamento nem repita a transferência automaticamente.
Limite importante: PIXC ainda não usa o endpoint de cobrança USDC/Lightning. Não envie preferredMethod: "pixc" ao WordFinance Pay. A integração PIXC é uma transferência SPL separada, aprovada pela carteira e verificada pelo backend do parceiro.
Segurança

Requisitos antes de produção

No cliente

  • Não solicitar seed, chave privada ou PIN fora da carteira.
  • Não preencher destino silenciosamente.
  • Mostrar o mint completo e a rede Solana.
  • Exigir aprovação explícita do usuário.

No servidor

  • Persistir pedido e valor esperado.
  • Consultar RPC confiável server-side.
  • Validar finalização e todos os campos.
  • Deduplicar pela assinatura.
  • Começar com flag desligada e homologação controlada.
English technical summary

PIXC integration in one paragraph

PIXC is a classic SPL token on Solana mainnet with 2 decimals. Identify it only by the official mint above, derive associated token accounts, build a checked SPL transfer, request explicit wallet approval and verify the finalized transaction server-side. Validate mint, sender, recipient, amount, time and transaction-signature uniqueness before delivering any product. Never place wallet secrets in frontend or backend code.

Copiar prompt completoAbrir no Solscan