Chain API

API para integracao com blockchain e o Real Digital (DREX). Interaja com smart contracts e realize operacoes tokenizadas.

Piloto DREX

A integracao DREX esta em fase de piloto regulado pelo Banco Central. Algumas funcionalidades podem ter disponibilidade limitada.

Base URL

Sandbox:    https://sandbox.chain.axon.com
Production: https://chain.axon.com

DREX Endpoints

POST

/v1/drex/transfers

Inicia uma transferencia de Real Digital

Requestjson

{
  "from_wallet": "0x1234567890abcdef1234567890abcdef12345678",
  "to_wallet": "0xabcdef1234567890abcdef1234567890abcdef12",
  "amount": "1000.00",
  "reference": "pay_123",
  "metadata": {
    "description": "Pagamento de servicos"
  }
}

Responsejson

{
  "transfer_id": "drex_tr_abc123",
  "status": "pending",
  "from_wallet": "0x1234...5678",
  "to_wallet": "0xabcd...ef12",
  "amount": "1000.00",
  "currency": "DREX",
  "tx_hash": null,
  "created_at": "2024-01-15T10:30:00Z"
}

GET

/v1/drex/transfers/{id}

Consulta status de uma transferencia

GET

/v1/drex/balance/{wallet}

Consulta saldo de uma carteira DREX

Responsejson

{
  "wallet": "0x1234567890abcdef1234567890abcdef12345678",
  "balance": "15000.00",
  "currency": "DREX",
  "updated_at": "2024-01-15T10:30:00Z"
}

Smart Contracts

POST

/v1/contracts/deploy

Faz deploy de um smart contract

Requestjson

{
  "template": "tokenized_asset",
  "params": {
    "name": "Real Estate Token",
    "symbol": "RET",
    "total_supply": "1000000",
    "decimals": 2
  },
  "network": "drex_testnet"
}

POST

/v1/contracts/{address}/call

Executa uma funcao de um smart contract

Requestjson

{
  "function": "transfer",
  "params": {
    "to": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "100"
  },
  "signer_wallet": "0x1234567890abcdef1234567890abcdef12345678"
}

GET

/v1/contracts/{address}

Consulta informacoes de um smart contract

Templates de Smart Contracts

Template	Descricao	Padrao
tokenized_asset	Ativo tokenizado generico	ERC-20
real_estate	Token imobiliario fracionado	ERC-1400
receivables	Recebiveis tokenizados	ERC-20
escrow	Contrato de garantia	Custom

Wallets

POST

/v1/wallets

Cria uma nova carteira gerenciada

Requestjson

{
  "type": "managed",
  "label": "Carteira Principal",
  "metadata": {
    "customer_id": "cust_123"
  }
}

Responsejson

{
  "wallet_id": "wal_abc123",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "type": "managed",
  "label": "Carteira Principal",
  "created_at": "2024-01-15T10:30:00Z"
}

GET

/v1/wallets

Lista todas as carteiras da conta

GET

/v1/wallets/{id}/transactions

Lista transacoes de uma carteira

Redes suportadas

Rede	ID	Ambiente
DREX Testnet	drex_testnet	Sandbox/Staging
DREX Mainnet	drex_mainnet	Production
Ethereum Sepolia	eth_sepolia	Sandbox
Polygon Mumbai	polygon_mumbai	Sandbox

Custos de gas

Operacoes em blockchain incorrem em custos de gas. No ambiente sandbox, o gas e fornecido automaticamente. Em producao, sua conta deve ter saldo suficiente.