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.
Marco Regulatorio y Cumplimiento
Section titled “Marco Regulatorio y Cumplimiento”- 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 enrecoveryHistory.
Instalación e Importación
Section titled “Instalación e Importación”npm install @linealqorum/react-native-sdkimport { linealToken, LinealToken } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:// linealToken.balanceOf(...);
// O crear una nueva instancia:const token = new LinealToken();Tabla Resumen de Métodos y Permisos
Section titled “Tabla Resumen de Métodos y Permisos”| 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 |
Control Operativo y Compliance
Section titled “Control Operativo y Compliance”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...');unpause
Section titled “unpause”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...');setWhitelist
Section titled “setWhitelist”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);setBlacklist
Section titled “setBlacklist”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);setDailyLimits
Section titled “setDailyLimits”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');setReserveBank
Section titled “setReserveBank”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...');Recuperación de Fondos
Section titled “Recuperación de Fondos”recoverFunds
Section titled “recoverFunds”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');Operaciones Estándar ERC20
Section titled “Operaciones Estándar ERC20”transfer
Section titled “transfer”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');approve
Section titled “approve”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');Consultas y Vistas
Section titled “Consultas y Vistas”balanceOf
Section titled “balanceOf”Tipo de Ejecución:
Normal(view) · Endpoint:/read-contract
const balance = await linealToken.balanceOf('0xTokenContractAddress...', '0xUserWallet...');console.log('Saldo:', balance);isWhitelisted / isBlacklisted
Section titled “isWhitelisted / isBlacklisted”Tipo de Ejecución:
Normal(view) · Endpoint:/read-contract
const kycOk = await linealToken.isWhitelisted('0xTokenContractAddress...', '0xUserWallet...');const blocked = await linealToken.isBlacklisted('0xTokenContractAddress...', '0xUserWallet...');getDailyTransferVolume
Section titled “getDailyTransferVolume”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...');