Skip to content

LinealToken

⏱ 5 min de lectura

El módulo LinealToken interactúa con la stablecoin institucional del protocolo Lineal Qorum, respaldada 1:1 por moneda fiduciaria (FIAT). Implementa un marco estricto de cumplimiento regulatorio: KYC en la entrada mediante listas blancas (whitelist), circulación abierta para transferencias, bloqueos reactivos (blacklist), auditoría de recuperaciones on-chain y límites de volumen diario.

  • Emisión y Quema Controlada: Solo el contrato autorizado de liquidez (LinealLiquidity) puede acuñar (mint) o quemar (burn) tokens, exigiendo que las cuentas de destino cuenten con KYC aprobado (isWhitelisted).
  • Circulación Libre: Las transferencias regulares entre usuarios no requieren validación de whitelist.
  • Bloqueos Reactivos (Blacklist): Las direcciones en lista negra tienen restringido tanto el envío como la recepción de fondos.
  • Recuperación ante Fraude: Fondos bloqueados en cuentas sancionadas pueden ser recuperados hacia cuentas limpias exclusivamente por quórum administrativo (recoverFunds), exigiendo justificación obligatoria y registro inmutable en recoveryHistory.

Terminal window
npm install @linealqorum/react-native-sdk
import { linealToken, LinealToken } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:
// linealToken.balanceOf(...);
// O crear una nueva instancia:
const token = new LinealToken();

Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
pause Only Signer (Servidores) onlyServers /send-only-signer-operation
unpause Only Signer (Servidores) onlyServers /send-only-signer-operation
setWhitelist Only Signer (Servidores) onlyServers /send-only-signer-operation
setBlacklist Only Signer (Servidores) onlyServers /send-only-signer-operation
launchPreSeed Only Signer (Servidores) onlyServers /send-only-signer-operation
launchSeed Only Signer (Servidores) onlyServers /send-only-signer-operation
setDailyLimits Only Signer (Servidores) onlyServers /send-only-signer-operation
setReserveBank Only Signer (Servidores) onlyServers /send-only-signer-operation
recoverFunds Multisig (Quórum) onlyQorum /send-operation
transfer Normal (Transacción) Público (ERC20) /send-transaction
transferFrom Normal (Transacción) Público (ERC20) /send-transaction
approve Normal (Transacción) Público (ERC20) /send-transaction
balanceOf Normal (Lectura) view (público) /read-contract
allowance Normal (Lectura) view (público) /read-contract
totalSupply Normal (Lectura) view (público) /read-contract
getCirculatingSupply Normal (Lectura) view (público) /read-contract
isWhitelisted Normal (Lectura) view (público) /read-contract
isBlacklisted Normal (Lectura) view (público) /read-contract
getDailyTransferVolume Normal (Lectura) view (público) /read-contract
getDailyMintBurnVolume Normal (Lectura) view (público) /read-contract
getMintHistoryLength Normal (Lectura) view (público) /read-contract
getBurnHistoryLength Normal (Lectura) view (público) /read-contract

Tipo de Ejecución: Only Signer (onlyServers) · Endpoint: /send-only-signer-operation

Pausa transferencias, emisiones y quemas del token.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
await linealToken.pause('0xTokenContractAddress...');

Tipo de Ejecución: Only Signer (onlyServers) · Endpoint: /send-only-signer-operation

Reanuda la actividad normal del token.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
await linealToken.unpause('0xTokenContractAddress...');

Tipo de Ejecución: Only Signer (onlyServers) · Endpoint: /send-only-signer-operation

Agrega o revoca una dirección de la lista blanca de KYC.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
account string Dirección de la cuenta a configurar.
status boolean true para admitir en whitelist, false para revocar.
await linealToken.setWhitelist('0xTokenContractAddress...', '0xUserWallet...', true);

Tipo de Ejecución: Only Signer (onlyServers) · Endpoint: /send-only-signer-operation

Bloquea o desbloquea una dirección ante investigaciones o sanciones.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
account string Dirección de la cuenta a bloquear/desbloquear.
status boolean true para bloquear, false para liberar.
await linealToken.setBlacklist('0xTokenContractAddress...', '0xSuspiciousWallet...', true);

Tipo de Ejecución: Only Signer (onlyServers) · Endpoint: /send-only-signer-operation

Ajusta los topes diarios de transferencias individuales, acuñación y quema global.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
transferLimit string | bigint Límite diario de transferencias por emisor en wei.
mintLimit string | bigint Límite diario global de emisión en wei.
burnLimit string | bigint Límite diario global de quema en wei.
await linealToken.setDailyLimits(
'0xTokenContractAddress...',
'27000000000000000000000000', // 27M tokens
'100000000000000000000000000', // 100M tokens
'100000000000000000000000000'
);

Tipo de Ejecución: Only Signer (onlyServers) · Endpoint: /send-only-signer-operation

Vincula la dirección del banco custodio del respaldo FIAT (solo puede fijarse una vez).

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
reserveBank string Dirección del banco de reserva.
await linealToken.setReserveBank('0xTokenContractAddress...', '0xBankAddress...');

Tipo de Ejecución: Multisig (onlyQorum) · Endpoint: /send-operation

Transfiere fondos desde una cuenta bloqueada en blacklist hacia una cuenta limpia autorizada. Requiere quórum y justificación obligatoria.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
from string Dirección de origen (debe estar en blacklist).
to string Dirección receptora (no puede estar en blacklist).
amount string | bigint Monto a transferir en unidades base.
reason string Motivo de la recuperación para auditoría on-chain.
await linealToken.recoverFunds(
'0xTokenContractAddress...',
'0xBlacklistedWallet...',
'0xTreasuryRecoveryWallet...',
'500000000000000000000',
'Orden judicial N° 84920 de recuperación de activos'
);

Tipo de Ejecución: Normal (Transacción) · Endpoint: /send-transaction

Transfiere tokens a otra billetera sujeta a verificación de blacklist y límite diario.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
to string Billetera de destino.
amount string | bigint Cantidad en unidades mínimas (wei).
await linealToken.transfer('0xTokenContractAddress...', '0xRecipientWallet...', '1000000000000000000');

Tipo de Ejecución: Normal (Transacción) · Endpoint: /send-transaction

Autoriza a un contrato (ej. LinealBank o LinealDex) a gastar tokens en nombre del usuario.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealToken.
spender string Dirección autorizada para debitar tokens.
amount string | bigint Cantidad autorizada.
await linealToken.approve('0xTokenContractAddress...', '0xSpenderAddress...', '5000000000000000000');

Tipo de Ejecución: Normal (view) · Endpoint: /read-contract

const balance = await linealToken.balanceOf('0xTokenContractAddress...', '0xUserWallet...');
console.log('Saldo:', balance);

Tipo de Ejecución: Normal (view) · Endpoint: /read-contract

const kycOk = await linealToken.isWhitelisted('0xTokenContractAddress...', '0xUserWallet...');
const blocked = await linealToken.isBlacklisted('0xTokenContractAddress...', '0xUserWallet...');

Tipo de Ejecución: Normal (view) · Endpoint: /read-contract

Consulta el volumen transferido hoy por una dirección particular.

const volumeToday = await linealToken.getDailyTransferVolume('0xTokenContractAddress...', '0xUserWallet...');