Skip to content

Primeros Pasos

⏱ 33 min de lectura

Terminal window
npm install @linealqorum/react-native-sdk

Agrega la configuración del DNS y/o la app federada para conectar con el nodo institucional:

// Configuración de red federada (DNS / App)
// Nota: La autenticación e interacción se realiza de forma descentralizada/on-chain y NO requiere API keys.

El módulo LinealInstitution proporciona una interfaz tipada para interactuar con los contratos institucionales del protocolo Lineal Qorum. Gestiona tokens admitidos, subcuentas bancarias, licitaciones tokenizadas, identidades de ciudadanos y consultas de estado on-chain.

import { linealInstitution, LinealInstitution } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:
// linealInstitution.getSubAccounts(...);
// O crear una nueva instancia:
const institution = new LinealInstitution();

Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
setTokenSupport Only Signer (Servidores) onlyServers /send-only-signer-operation
setPairToken Only Signer (Servidores) onlyServers /send-only-signer-operation
setCitizensAddress Only Signer (Servidores) onlyServers /send-only-signer-operation
createSubAccount Multisig (Quórum) onlyQorum /send-operation
moveFundsToSubAccount Multisig (Quórum) onlyQorum /send-operation
moveFundsToBank Multisig (Quórum) onlyQorum /send-operation
releaseFromBank Multisig (Quórum) onlyQorum /send-operation
releasePreSale Only Signer (Servidores) onlyServers /send-only-signer-operation
mintTender Multisig (Quórum) onlyQorum /send-operation
mintProfile Only Signer (Servidores) onlyServers /send-only-signer-operation
updateIdentityScore Only Signer (Servidores) onlyServers /send-only-signer-operation
setProfileImageURI Only Signer (Servidores) onlyServers /send-only-signer-operation
setDescription Multisig (Quórum) onlyQorum /send-operation
getDirectiva Normal (Lectura) view (público) Consulta de lectura
getSubAccounts Normal (Lectura) view (público) Consulta de lectura
getInstitutionBank Normal (Lectura) view (público) Consulta de lectura
getInstitutionTender Normal (Lectura) view (público) Consulta de lectura
getIdentity Normal (Lectura) view (público) Consulta de lectura
getRewardsAccountId Normal (Lectura) view (público) Consulta de lectura
getBankTokens Normal (Lectura) view (público) Consulta de lectura
getAccountBalances Normal (Lectura) view (público) Consulta de lectura

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

Habilita o revoca el soporte de un token ERC20 dentro del banco institucional. Requiere la firma del quórum de servidores/firmantes autorizados.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
token string Dirección hexadecimal (0x...) del contrato del token ERC20.
supported boolean true para admitir el token en el banco institucional, false para deshabilitarlo.

Retorno: Promise<any>

await linealInstitution.setTokenSupport(
'0xInstitutionContractAddress...',
'0xTokenContractAddress...',
true
);

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

Configura el token secundario de emparejamiento para operaciones financieras dentro de la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
token string Dirección hexadecimal (0x...) del token par a vincular.

Retorno: Promise<any>

await linealInstitution.setPairToken(
'0xInstitutionContractAddress...',
'0xPairTokenContractAddress...'
);

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

Vincula la dirección del contrato LinealCitizens (registro de identidades soulbound) a la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
citizensAddress string Dirección hexadecimal (0x...) del contrato LinealCitizens.

Retorno: Promise<any>

await linealInstitution.setCitizensAddress(
'0xInstitutionContractAddress...',
'0xCitizensContractAddress...'
);

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

Crea una nueva subcuenta dentro del banco institucional para organizar fondos según departamentos o propósitos específicos. Requiere quórum tripartito.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
accountName string Nombre descriptivo de la nueva subcuenta (ej. "Tesoreria", "Operaciones").

Retorno: Promise<any>

const result = await linealInstitution.createSubAccount(
'0xInstitutionContractAddress...',
'Tesoreria-General'
);

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

Transfiere fondos entre subcuentas internas del mismo banco institucional. Requiere quórum tripartito.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
fromAccount number | string Identificador (ID) de la subcuenta de origen.
toAccount number | string Identificador (ID) de la subcuenta de destino.
token string Dirección hexadecimal (0x...) del token a transferir.
amount string | bigint Cantidad de tokens a transferir en formato wei/unidades base.

Retorno: Promise<any>

await linealInstitution.moveFundsToSubAccount(
'0xInstitutionContractAddress...',
1,
2,
'0xTokenContractAddress...',
'1000000000000000000'
);

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

Transfiere fondos desde una subcuenta local hacia otra institución bancaria federada. Requiere quórum tripartito.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution local.
fromAccount number | string ID de la subcuenta de origen en el banco emisor.
destBank string Dirección hexadecimal (0x...) del banco institucional de destino.
toAccount number | string ID de la subcuenta destino en el banco receptor.
token string Dirección hexadecimal (0x...) del token transferido.
amount string | bigint Monto bruto a transferir en formato wei.

Retorno: Promise<any>

await linealInstitution.moveFundsToBank(
'0xInstitutionContractAddress...',
1,
'0xDestBankContractAddress...',
3,
'0xTokenContractAddress...',
'500000000000000000'
);

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

Libera fondos retenidos en una subcuenta del banco hacia una dirección externa (billetera), exigiendo una justificación auditada on-chain. Requiere quórum tripartito.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
accountId number | string ID de la subcuenta desde la que se liberarán los fondos.
token string Dirección hexadecimal (0x...) del token a liberar.
to string Dirección hexadecimal de la billetera receptora.
amount string | bigint Cantidad de tokens a liberar en formato wei.
reason string Motivo de la liberación que quedará registrado on-chain para auditoría.

Retorno: Promise<any>

await linealInstitution.releaseFromBank(
'0xInstitutionContractAddress...',
1,
'0xTokenContractAddress...',
'0xBeneficiaryWallet...',
'200000000000000000',
'Pago correspondiente a adjudicación de licitación N° 402'
);

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

Libera los fondos acumulados durante una preventa hacia la subcuenta del ciudadano beneficiario. Requiere quórum de servidores.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
token string Dirección hexadecimal (0x...) del token a transferir.
to string Dirección de la billetera del ciudadano destinatario.
amount string | bigint Monto total a liberar en formato wei.

Retorno: Promise<any>

await linealInstitution.releasePreSale(
'0xInstitutionContractAddress...',
'0xTokenContractAddress...',
'0xCitizenWallet...',
'50000000000000000000'
);

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

Emite y registra una nueva licitación (ERC-721) respaldada por el presupuesto institucional. Requiere quórum tripartito.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
title string Título de la licitación (máximo 100 bytes).
tenderDescription string Descripción detallada del alcance, requerimientos y plazos.
imageURI string URI de la imagen representativa (por ejemplo ipfs://...).
documentURL string Enlace permanente a las bases legales/técnicas de la licitación.
amount string | bigint Presupuesto total asignado a la licitación en wei.

Retorno: Promise<any>

const tender = await linealInstitution.mintTender(
'0xInstitutionContractAddress...',
'Mantenimiento de Red de Fibra Óptica',
'Licitación para soporte técnico y tendido de cableado estructurado.',
'ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi',
'https://gobierno.cl/licitaciones/2026/bases-red.pdf',
'15000000000000000000000'
);

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

Acuña el perfil de identidad soulbound (no transferible) para un ciudadano y le crea automáticamente su subcuenta en el banco. Requiere quórum de servidores.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
wallet string Dirección de la cuenta/billetera del ciudadano receptor.
username string Nombre de usuario o identificador público del ciudadano.
imageURI string URI del avatar o fotografía de identidad (ej. IPFS).

Retorno: Promise<any>

await linealInstitution.mintProfile(
'0xInstitutionContractAddress...',
'0xCitizenWalletAddress...',
'camila_valenzuela',
'ipfs://QmAvatarHash123...'
);

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

Modifica el puntaje de reputación on-chain asignado a un perfil ciudadano. Requiere quórum de servidores.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
tokenId number | string ID del token NFT soulbound del ciudadano.
delta number Magnitud o cantidad de puntos a ajustar.
positive boolean true si es un incremento de reputación, false si es una penalización/decremento.

Retorno: Promise<any>

await linealInstitution.updateIdentityScore(
'0xInstitutionContractAddress...',
1,
25,
true
);

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

Actualiza el enlace o avatar visual de un perfil ciudadano existente. Requiere quórum de servidores.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
wallet string Dirección de la billetera del ciudadano cuyo perfil se actualiza.
newImageURI string Nueva URI de imagen (IPFS u hosting descentralizado).

Retorno: Promise<any>

await linealInstitution.setProfileImageURI(
'0xInstitutionContractAddress...',
'0xCitizenWalletAddress...',
'ipfs://QmNuevoAvatarHash...'
);

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

Actualiza la descripción pública de la institución registrada on-chain. Requiere quórum tripartito.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
newDescription string Nuevo texto descriptivo de la institución.

Retorno: Promise<any>

await linealInstitution.setDescription(
'0xInstitutionContractAddress...',
'Entidad Pública Descentralizada para Infraestructura Crítica'
);

Métodos de consulta de solo lectura (view).

Tipo de Ejecución: Normal (view)

Obtiene la lista de direcciones que conforman la directiva/consejo administrativo de la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.

Retorno: Promise<any> — Arreglo de direcciones de directores institucionales.

const directiva = await linealInstitution.getDirectiva('0xInstitutionContractAddress...');
console.log('Miembros directiva:', directiva);

Tipo de Ejecución: Normal (view)

Obtiene la lista completa de identificadores de subcuentas registradas bajo el banco de la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.

Retorno: Promise<any> — Listado de bytes32 con los IDs de las subcuentas.

const subAccounts = await linealInstitution.getSubAccounts('0xInstitutionContractAddress...');

Tipo de Ejecución: Normal (view)

Consulta la dirección del contrato LinealBank asociado a esta institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.

Retorno: Promise<any> — Dirección hexadecimal del banco.

const bankAddress = await linealInstitution.getInstitutionBank('0xInstitutionContractAddress...');

Tipo de Ejecución: Normal (view)

Consulta la dirección del contrato LinealTender vinculado a la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.

Retorno: Promise<any> — Dirección del contrato de licitaciones.

const tenderContract = await linealInstitution.getInstitutionTender('0xInstitutionContractAddress...');

Tipo de Ejecución: Normal (view)

Consulta la dirección del contrato LinealCitizens asignado a la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.

Retorno: Promise<any> — Dirección del contrato de identidad.

const identityContract = await linealInstitution.getIdentity('0xInstitutionContractAddress...');

Tipo de Ejecución: Normal (view)

Obtiene el identificador de la subcuenta destinada al fondo de recompensas de la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.

Retorno: Promise<any> — ID en bytes32 de la cuenta de recompensas.

const rewardsId = await linealInstitution.getRewardsAccountId('0xInstitutionContractAddress...');

Tipo de Ejecución: Normal (view)

Obtiene la lista de direcciones de tokens admitidos en el banco institucional.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.

Retorno: Promise<any> — Arreglo con las direcciones de los tokens soportados.

const tokens = await linealInstitution.getBankTokens('0xInstitutionContractAddress...');

Tipo de Ejecución: Normal (view)

Consulta los saldos disponibles de todos los tokens soportados para una subcuenta específica.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealInstitution.
accountId number | string Identificador de la subcuenta a consultar.

Retorno: Promise<any> — Mapeo de tokens y saldos correspondientes.

const balances = await linealInstitution.getAccountBalances(
'0xInstitutionContractAddress...',
1
);
console.log('Saldos de la subcuenta:', balances);

El módulo LinealBank permite gestionar la interacción con el banco institucional del protocolo Lineal Qorum. Ofrece custodia multi-token (ERC20) organizada en subcuentas independientes, depósitos directos, retiros y transferencias individuales para ciudadanos (cuentas personales soberanas) y consultas de saldos y reservas.

  • Subcuentas Independientes: Cada subcuenta (institucional, departamental o de ciudadano) mantiene un registro de saldo separado para cada token habilitado.
  • Cuentas Personales Soberanas: Las cuentas de los ciudadanos dentro del banco institucional solo pueden ser movidas por la firma de su titular (releaseFromMyAccount, moveFromMyAccount, individualTransferToBank). Ni la directiva ni el quórum de la institución pueden disponer de ellas arbitrariamente.
  • Tarifa de Recompensas (Rewards Fee): Las transferencias internas entre subcuentas descuentan un porcentaje en puntos básicos (bps) que se acredita de manera automática a la subcuenta institucional de recompensas.

import { linealBank, LinealBank } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:
// linealBank.accountBalancesAll(...);
// O crear una nueva instancia:
const bank = new LinealBank();

Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
deposit Normal (Transacción de usuario) Público / nonReentrant /send-transaction
releaseFromMyAccount Normal (Transacción de usuario) Público (Dueño de cuenta) /send-transaction
moveFromMyAccount Normal (Transacción de usuario) Público (Dueño de cuenta) /send-transaction
individualTransferToBank Normal (Transacción de usuario) Público (Dueño de cuenta) /send-transaction
isTokenSupported Normal (Lectura) view (público) /read-contract
accountOf Normal (Lectura) view (público) /read-contract
accountBalance Normal (Lectura) view (público) /read-contract
accountBalancesAll Normal (Lectura) view (público) /read-contract
tokenList Normal (Lectura) view (público) /read-contract
totalReserveBalance Normal (Lectura) view (público) /read-contract

Métodos ejecutados directamente por la billetera del usuario a través de transacciones estándar (/send-transaction).

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

Deposita tokens ERC20 en una subcuenta del banco institucional. Requiere aprobación previa de tokens (approve) en el contrato ERC20 correspondiente y que el token esté admitido (supportedToken).

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.
accountId string Identificador bytes32 de la subcuenta receptora de los fondos.
tokenAddr string Dirección hexadecimal (0x...) del contrato del token ERC20 a depositar.
amount string | bigint Monto a depositar en formato wei/unidades base.

Retorno: Promise<any> — Comprobante del despacho de la transacción.

await linealBank.deposit(
'0xBankContractAddress...',
'0x4163636f756e7449640000000000000000000000000000000000000000000000', // accountId bytes32
'0xTokenContractAddress...',
'1000000000000000000' // 1.0 token
);

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

Permite al titular de una cuenta personal retirar tokens desde su subcuenta en el banco hacia una dirección externa (billetera receptora).

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.
tokenAddr string Dirección hexadecimal (0x...) del token a retirar.
to string Dirección de la billetera destino que recibirá los tokens.
amount string | bigint Cantidad de tokens a retirar en formato wei.

Retorno: Promise<any>

await linealBank.releaseFromMyAccount(
'0xBankContractAddress...',
'0xTokenContractAddress...',
'0xRecipientWallet...',
'500000000000000000'
);

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

Transfiere fondos desde la subcuenta personal del usuario hacia otra subcuenta interna dentro del mismo banco institucional (aplica fee de recompensas).

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.
toAccount string Identificador bytes32 de la subcuenta destino dentro del banco.
tokenAddr string Dirección hexadecimal (0x...) del token a transferir.
amount string | bigint Monto a transferir en unidades base.

Retorno: Promise<any>

await linealBank.moveFromMyAccount(
'0xBankContractAddress...',
'0xDestSubAccountId...',
'0xTokenContractAddress...',
'250000000000000000'
);

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

Transfiere fondos desde la subcuenta del usuario hacia una subcuenta en el banco de OTRA institución federada.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank emisor.
destBank string Dirección hexadecimal (0x...) del contrato LinealBank de destino.
toAccount string Identificador bytes32 de la subcuenta receptora en el banco destino.
tokenAddr string Dirección hexadecimal (0x...) del token transferido.
amount string | bigint Monto bruto a transferir en formato wei.

Retorno: Promise<any>

await linealBank.individualTransferToBank(
'0xBankContractAddress...',
'0xDestBankContractAddress...',
'0xRecipientSubAccountId...',
'0xTokenContractAddress...',
'100000000000000000'
);

Métodos de consulta de solo lectura (view) a través de /read-contract.

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

Verifica si un token ERC20 está habilitado para depósitos en el banco institucional.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.
tokenAddr string Dirección hexadecimal (0x...) del token a consultar.

Retorno: Promise<boolean> — true si el token está admitido, false en caso contrario.

const supported = await linealBank.isTokenSupported(
'0xBankContractAddress...',
'0xTokenContractAddress...'
);
console.log('¿Token admitido?:', supported);

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

Obtiene el identificador bytes32 de la cuenta personal asignada a una dirección de billetera en este banco.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.
wallet string Dirección hexadecimal de la billetera del usuario.

Retorno: Promise<string> — Identificador bytes32 de la subcuenta.

const accountId = await linealBank.accountOf(
'0xBankContractAddress...',
'0xUserWalletAddress...'
);
console.log('Subcuenta del usuario:', accountId);

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

Consulta el saldo disponible de un token específico para una subcuenta determinada.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.
accountId string Identificador bytes32 de la subcuenta.
tokenAddr string Dirección hexadecimal (0x...) del token consultado.

Retorno: Promise<any> — Saldo de la subcuenta en formato numérico/wei.

const balance = await linealBank.accountBalance(
'0xBankContractAddress...',
'0xSubAccountId...',
'0xTokenContractAddress...'
);
console.log('Saldo disponible:', balance);

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

Consulta los saldos de todos los tokens registrados en el banco para una subcuenta determinada.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.
accountId string Identificador bytes32 de la subcuenta.

Retorno: Promise<any> — Arreglo de tokens y arreglo de saldos correspondientes.

const balances = await linealBank.accountBalancesAll(
'0xBankContractAddress...',
'0xSubAccountId...'
);
console.log('Saldos completos de la subcuenta:', balances);

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

Retorna la lista de todas las direcciones de tokens que han sido registrados en el banco institucional (habilitados o deshabilitados).

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.

Retorno: Promise<string[]> — Lista de direcciones de tokens registrados.

const tokens = await linealBank.tokenList('0xBankContractAddress...');
console.log('Tokens en banco:', tokens);

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

Consulta el balance total en reserva custodiado por el contrato LinealBank para un token determinado (saldo real del contrato en el token ERC20).

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealBank.
tokenAddr string Dirección hexadecimal (0x...) del token a consultar.

Retorno: Promise<any> — Balance total custodiado en unidades base.

const reserve = await linealBank.totalReserveBalance(
'0xBankContractAddress...',
'0xTokenContractAddress...'
);
console.log('Reserva total del token en el banco:', reserve);

El módulo LinealCitizens permite consultar la información de identidad ciudadana on-chain dentro del protocolo Lineal Qorum. Las identidades son tokens soulbound (ERC-721 no transferibles) que asocian la billetera del ciudadano con su nombre de usuario, avatar, subcuenta bancaria, reputación y nivel dentro de la institución.

  • Soulbound Token (SBT): El token está ligado permanentemente a la billetera del ciudadano y no puede ser transferido ni vendido.
  • Puntaje de Reputación: Rango de 0 a 10.000 puntos.
  • Niveles de Reputación:
    • Ciudadano: < 2.000 puntos.
    • Jugador: ≥ 2.000 puntos.
    • Operador: ≥ 4.000 puntos.
    • Agente: ≥ 6.000 puntos.
    • Principal: ≥ 8.000 puntos.
    • Anomalia: ≥ 9.500 puntos o 5 veces el promedio global de la institución.

import { linealCitizens, LinealCitizens } from '@linealqorum/react-native-sdk';
// Usar la instancia singleton predeterminada:
// linealCitizens.getProfile(...);
// O crear una nueva instancia:
const citizens = new LinealCitizens();

Todos los métodos expuestos por LinealCitizens en el SDK son consultas públicas de solo lectura (view):

Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
getProfile Normal (Lectura) view (público) /read-contract
getProfileByToken Normal (Lectura) view (público) /read-contract
getTokenCounter Normal (Lectura) view (público) /read-contract
getReputation Normal (Lectura) view (público) /read-contract
subAccountOf Normal (Lectura) view (público) /read-contract
tokenURI Normal (Lectura) view (público) /read-contract

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

Obtiene la información completa del perfil ciudadano asociado a una dirección de billetera.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealCitizens.
wallet string Dirección hexadecimal (0x...) de la billetera del ciudadano.

Retorno: Promise<any> — Objeto con tokenId, username, imageURI, subAccountId, reputation y level.

const profile = await linealCitizens.getProfile(
'0xCitizensContractAddress...',
'0xCitizenWalletAddress...'
);
console.log('Perfil ciudadano:', profile);
// Salida esperada:
// {
// tokenId: 1,
// username: "camila_valenzuela",
// imageURI: "ipfs://QmAvatar...",
// subAccountId: "0x3a4f...",
// reputation: 2500,
// level: "Jugador"
// }

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

Obtiene los datos del perfil ciudadano utilizando el identificador numérico de su token NFT soulbound.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealCitizens.
tokenId number | string Identificador único (tokenId) del NFT del ciudadano.

Retorno: Promise<any> — Estructura Profile y el nivel de reputación calculado.

const profile = await linealCitizens.getProfileByToken(
'0xCitizensContractAddress...',
1
);
console.log('Perfil por Token ID:', profile);

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

Devuelve la cantidad total de perfiles ciudadanos emitidos hasta el momento en la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealCitizens.

Retorno: Promise<any> — Contador numérico total de identidades acuñadas.

const totalCitizens = await linealCitizens.getTokenCounter(
'0xCitizensContractAddress...'
);
console.log('Total de ciudadanos registrados:', totalCitizens);

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

Consulta el puntaje numérico de reputación y el rango/nivel actual de un ciudadano a partir de su tokenId.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealCitizens.
tokenId number | string Identificador del token del ciudadano.

Retorno: Promise<any> — Objeto con overall (puntaje de 0 a 10.000) y level (categoría).

const rep = await linealCitizens.getReputation(
'0xCitizensContractAddress...',
1
);
console.log(`Puntaje: ${rep.overall}, Rango: ${rep.level}`);

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

Consulta el identificador bytes32 de la subcuenta bancaria personal asociada a la billetera del ciudadano dentro del banco institucional.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealCitizens.
wallet string Dirección de la billetera del ciudadano.

Retorno: Promise<any> — Identificador bytes32 de la subcuenta bancaria (o bytes32(0) si no posee perfil).

const subAccountId = await linealCitizens.subAccountOf(
'0xCitizensContractAddress...',
'0xCitizenWalletAddress...'
);
console.log('Subcuenta bancaria del ciudadano:', subAccountId);

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

Devuelve la metadata completa del NFT en formato JSON codificado en base64 (data:application/json;base64,...) según el estándar ERC-721, conteniendo atributos como reputación, institución, subcuenta y nivel.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealCitizens.
tokenId number | string Identificador único del token NFT soulbound.

Retorno: Promise<any> — Cadena data URI con los metadatos y atributos del NFT.

const metadataURI = await linealCitizens.tokenURI(
'0xCitizensContractAddress...',
1
);
console.log('Token URI:', metadataURI);

title: LinealToken description: Referencia completa de métodos, tipos de ejecución, cumplimiento normativo y ejemplos del módulo LinealToken del SDK.

Section titled “title: LinealToken description: Referencia completa de métodos, tipos de ejecución, cumplimiento normativo y ejemplos del módulo LinealToken del SDK.”

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...');

El módulo LinealLiquidity actúa como el orquestador de liquidez y política monetaria del protocolo Lineal Qorum. Regula la emisión de tokens, gestiona rondas de financiamiento inicial (Seed y PreSeed), implementa la Política de Conservación de Liquidez (LCL) con compras y quemas automáticas (Buyback & Burn), y desbloquea emisiones calculadas a partir del Índice de Desempeño (IDP).

  • Índice Alpha ((\alpha)): Relación entre la liquidez disponible en el AMM y el suministro circulante. Si Alpha cae por debajo del umbral crítico, los ingresos del protocolo disparan Buyback & Burn en el DEX para restaurar la estabilidad.
  • Emisión Regulada (IDP): Las nuevas emisiones de tokens se autorizan a través de unlockAndMint, donde el monto final depende directamente de los hitos institucionales aprobados por los ciudadanos (LinealMilestones).
  • Pausabilidad de Emergencia: Quórum administrativo para congelar o reactivar operaciones críticas de liquidez.
import { linealLiquidity, LinealLiquidity } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:
// linealLiquidity.unlockAndMint(...);
// O crear una nueva instancia:
const liquidity = new LinealLiquidity();
Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
pause Multisig (Quórum) onlyQorum /send-operation
unpause Multisig (Quórum) onlyQorum /send-operation
launchSeed Only Signer (Servidores) onlyServers /send-only-signer-operation
launchPreSeed Only Signer (Servidores) onlyServers /send-only-signer-operation
withdrawUnsoldTokens Only Signer (Servidores) onlyServers /send-only-signer-operation
unlockAndMint Only Signer (Servidores) onlyServers /send-only-signer-operation

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

Pausa todas las funciones de emisión y retiro de liquidez ante situaciones imprevistas o de emergencia. Requiere quórum completo.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealLiquidity.

Retorno: Promise<any> — Comprobante de la transacción despachada.

await linealLiquidity.pause('0xLiquidityContractAddress...');

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

Reanuda las operaciones normales de liquidez y desbloqueos. Requiere quórum completo.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealLiquidity.
await linealLiquidity.unpause('0xLiquidityContractAddress...');

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

Inicia la ronda Seed vinculando y activando el contrato LinealSeed para distribución de capital con vesting.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealLiquidity.
linealSeed string Dirección hexadecimal (0x...) del contrato LinealSeed.
await linealLiquidity.launchSeed(
'0xLiquidityContractAddress...',
'0xSeedContractAddress...'
);

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

Configura y abre la preventa inicial (Pre-Seed) fijando oferta total y precios base de entrada.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealLiquidity.
totalAmount string | bigint Monto total de tokens destinados a la ronda Pre-Seed en formato wei.
initialPriceToken string | bigint Precio base por unidad de token durante la ronda.
initialPriceNft string | bigint Precio base de acceso a identidades/NFTs asociados en preventa.
await linealLiquidity.launchPreSeed(
'0xLiquidityContractAddress...',
'1000000000000000000000000', // 1.000.000 tokens
'100000000000000000', // 0.1 stablecoin por token
'50000000000000000000' // 50 stablecoins por NFT
);

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

Recupera los tokens remanentes no vendidos tras la culminación de una ronda de financiamiento en LinealSeed.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealLiquidity.
linealSeed string Dirección hexadecimal (0x...) del contrato de la ronda finalizada.
await linealLiquidity.withdrawUnsoldTokens(
'0xLiquidityContractAddress...',
'0xSeedContractAddress...'
);

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

Ejecuta el ciclo de cálculo de emisión controlada: evalúa el índice Alpha y el IDP de LinealMilestones. Si Alpha es insuficiente, ejecuta recompra y quema con los ingresos disponibles; si Alpha es óptimo, emite la fracción proporcional de nuevos tokens hacia el destinatario institucional.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealLiquidity.
recipient string Dirección de la cuenta/banco institucional receptora de los nuevos tokens.
baseEmissionAmount string | bigint Monto base de emisión solicitado antes del ponderado por IDP.
tokenAddress string Dirección hexadecimal (0x...) del token emitido (LinealToken).
milestoneAddress string Dirección del contrato LinealMilestones que valida el IDP.
linealSwap string Dirección del AMM/DEX (LinealDex) para recompra y quema.
incomeToken string Dirección del token de ingresos utilizado para el Buyback.
availableIncomeForBuyback string | bigint Fondos de ingresos asignados para ejecutar la recompra si Alpha es bajo.
await linealLiquidity.unlockAndMint(
'0xLiquidityContractAddress...',
'0xInstitutionTreasuryWallet...',
'50000000000000000000000', // 50.000 tokens base
'0xLinealTokenAddress...',
'0xMilestonesAddress...',
'0xLinealDexAddress...',
'0xStableCoinAddress...',
'10000000000000000000000' // 10.000 stablecoins disponibles para buyback
);

El módulo LinealMilestones implementa el sistema de evaluación participativa de la gestión institucional en el protocolo Lineal Qorum. Permite proponer hitos de desarrollo o cumplimiento, someterlos a votación ciudadana y computar el Índice de Desempeño (IDP), métrica que desbloquea y condiciona directamente las emisiones monetarias en LinealLiquidity.

  • Cálculo del IDP (0–100): Cada hito posee un peso relativo (weight). Al ser aprobado por votación ciudadana antes de la fecha límite, su peso suma al IDP total de la institución.
  • Voto Ciudadano: Los ciudadanos habilitados con NFT soulbound (LinealCitizens) participan votando a favor o en contra de la finalización de los compromisos institucionales.
  • Gobernanza: La creación de hitos es realizada por servidores/firmantes (onlyServers), mientras que la cancelación, emisión de voto y cierre pasan por quórum administrativo y validación on-chain.
import { linealMilestones, LinealMilestones } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:
// linealMilestones.idp(...);
// O crear una nueva instancia:
const milestones = new LinealMilestones();
Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
createMilestone Only Signer (Servidores) onlyServers /send-only-signer-operation
cancelMilestone Multisig (Quórum) onlyQorum /send-operation
vote Multisig (Quórum) onlyQorum /send-operation
finalize Multisig (Quórum) onlyQorum /send-operation
idp Normal (Lectura) view (público) /send-operation
milestonesCount Normal (Lectura) view (público) /send-operation

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

Crea y abre a evaluación un nuevo hito institucional con peso de desempeño y plazo de votación. Requiere quórum de servidores.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealMilestones.
weight number Ponderación o peso del hito en el IDP (la suma de pesos activos no debe exceder 100).
duration number Duración del periodo de votación en segundos (plazo límite).

Retorno: Promise<any> — Objeto con el identificador del nuevo hito creado.

await linealMilestones.createMilestone(
'0xMilestonesContractAddress...',
25, // Peso: 25 puntos de IDP
604800 // Duración: 7 días (en segundos)
);

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

Cancela un hito activo antes de su vencimiento si se suspende el objetivo institucional. Requiere quórum tripartito.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealMilestones.
id number | string Identificador del hito a cancelar.
await linealMilestones.cancelMilestone(
'0xMilestonesContractAddress...',
1 // ID del hito
);

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

Registra el voto (a favor o en contra) sobre el cumplimiento del hito especificado.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealMilestones.
id number | string Identificador del hito sometido a votación.
support boolean true para votar favorablemente por la aprobación del hito, false en contra.
await linealMilestones.vote(
'0xMilestonesContractAddress...',
1,
true // Voto a favor
);

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

Cierra un hito cuyo plazo ha concluido, consolidando los resultados de la votación y actualizando formalmente el IDP.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealMilestones.
id number | string Identificador del hito a finalizar.
await linealMilestones.finalize(
'0xMilestonesContractAddress...',
1
);

Tipo de Ejecución: Normal (Lectura) · Endpoint: /send-operation

Consulta el valor actual del Índice de Desempeño (IDP) de la institución (escala de 0 a 100), el cual determina la proporción de tokens que LinealLiquidity tiene permitido emitir.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealMilestones.

Retorno: Promise<number> — Valor actual del IDP institucional.

const currentIdp = await linealMilestones.idp('0xMilestonesContractAddress...');
console.log('IDP actual de la institución:', currentIdp);

Tipo de Ejecución: Normal (Lectura) · Endpoint: /send-operation

Obtiene la cantidad total de hitos creados en el contrato.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealMilestones.

Retorno: Promise<number> — Total de hitos registrados.

const total = await linealMilestones.milestonesCount('0xMilestonesContractAddress...');
console.log('Cantidad total de hitos:', total);

El módulo LinealRouter gestiona la distribución automatizada de los ingresos (revenue splitter) generados por el protocolo Lineal Qorum. Permite configurar receptores con porcentajes definidos en puntos básicos (bps, base 10.000) y etiquetas descriptivas para derivar fondos a pools de recompensa, tesorería institucional o quemas automáticas (Buyback & Burn).

  • Configuración Dinámica: La distribución no está acoplada a direcciones estáticas; el quórum de servidores puede redefinir la lista de hasta 20 beneficiarios mediante setDistribution.
  • Base Puntos Básicos: La suma total de los bpsValues debe ser exactamente igual a 10.000 (100%).
  • Ejecución Central: El método distributeRevenue reparte los tokens de ingreso recibidos (por ejemplo stablecoin o token puente) hacia los beneficiarios configurados.
import { linealRouter, LinealRouter } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:
// linealRouter.getAllRecipients(...);
// O crear una nueva instancia:
const router = new LinealRouter();
Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
setFeeSplitter Only Signer (Servidores) onlyServers /send-only-signer-operation
setDistribution Only Signer (Servidores) onlyServers /send-only-signer-operation
pause Only Signer (Servidores) onlyServers /send-only-signer-operation
unpause Only Signer (Servidores) onlyServers /send-only-signer-operation
distributeRevenue Multisig / Operación whenNotPaused /send-operation
getRecipientsCount Normal (Lectura) view (público) /read-contract
getAllRecipients Normal (Lectura) view (público) /read-contract

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

Autoriza la dirección de LinealLiquidity encargada de enviar fondos de ingresos para su dispersión.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealRouter.
linealLiquidity string Dirección del contrato de liquidez autorizado.
await linealRouter.setFeeSplitter('0xRouterContractAddress...', '0xLiquidityContractAddress...');

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

Establece o actualiza la lista de destinatarios, ponderaciones en bps y etiquetas informativas.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealRouter.
accounts string[] Arreglo de direcciones receptoras.
bpsValues number[] Arreglo de enteros en basis points (la suma debe totalizar 10.000).
labels string[] Etiquetas descriptivas para cada destinatario.
await linealRouter.setDistribution(
'0xRouterContractAddress...',
[
'0xTreasuryWallet...',
'0xRewardsPoolWallet...',
'0xDevFundWallet...'
],
[5000, 3000, 2000], // 50%, 30%, 20%
['Tesorería Institucional', 'Fondo de Recompensas', 'Desarrollo de Infraestructura']
);

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

Pausa o reanuda la ejecución del reparto de ingresos en el router.

await linealRouter.pause('0xRouterContractAddress...');
await linealRouter.unpause('0xRouterContractAddress...');

Tipo de Ejecución: Multisig / Operación · Endpoint: /send-operation

Dispersa un monto específico de tokens de ingresos acumulados entre todos los destinatarios activos.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealRouter.
incomeAmount string | bigint Monto de tokens a distribuir en formato wei.
await linealRouter.distributeRevenue(
'0xRouterContractAddress...',
'10000000000000000000000' // 10.000 unidades de ingreso
);

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

const count = await linealRouter.getRecipientsCount('0xRouterContractAddress...');
console.log('Cantidad de receptores:', count);

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

Obtiene la lista completa de receptores con sus direcciones, porcentajes en bps y etiquetas descriptivas.

const recipients = await linealRouter.getAllRecipients('0xRouterContractAddress...');
console.log('Destinatarios vigentes:', recipients);

El módulo LinealSeed interactúa con el contrato de venta y vesting de tokens de financiamiento temprano (Seed Round) del ecosistema Lineal Qorum. Soporta aportes con tokens de pago (USDC, USDT), metas de recaudación (softCap y hardCap), calendario de liberación (vesting) y garantías de devolución (refund) si no se alcanza la meta mínima.

  • Esquema de Desbloqueo:
    • 20% (2.000 bps) liberado de forma inmediata al finalizar la venta con éxito (TGE).
    • 80% (8.000 bps) liberado tras un periodo de cliff de 180 días (~6 meses) desde el TGE.
  • Éxito (SoftCap): Si totalRaised >= softCap, la venta es exitosa: los compradores pueden reclamar (claim) sus tokens desbloqueados y el owner retira los fondos con withdrawFunds.
  • Garantía de Reembolso (Refund): Si al vencer el plazo de venta no se alcanza el softCap, los compradores pueden solicitar el reembolso íntegro de su pago en el mismo token aportado (refund).
import { linealSeed, LinealSeed } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:
// linealSeed.claimable(...);
// O crear una nueva instancia:
const seed = new LinealSeed();
Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
buy Normal (Transacción) nonReentrant (público) /send-transaction
finalize Normal (Transacción) Público (cualquiera) /send-transaction
claim Normal (Transacción) nonReentrant (comprador) /send-transaction
refund Normal (Transacción) nonReentrant (comprador) /send-transaction
withdrawFunds Only Signer / Owner onlyOwner /send-only-signer-operation
withdrawUnsoldTokens Only Signer / Owner onlyOwner /send-only-signer-operation
claimable Normal (Lectura) view (público) /read-contract
totalRaised Normal (Lectura) view (público) /read-contract
totalSold Normal (Lectura) view (público) /read-contract
totalClaimed Normal (Lectura) view (público) /read-contract
finalized Normal (Lectura) view (público) /read-contract
successful Normal (Lectura) view (público) /read-contract
contributed Normal (Lectura) view (público) /read-contract
purchased Normal (Lectura) view (público) /read-contract
claimed Normal (Lectura) view (público) /read-contract

Operaciones de Comprador (Venta y Vesting)

Section titled “Operaciones de Comprador (Venta y Vesting)”

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

Compra tokens de la venta pagando con el token acordado (paymentToken). Requiere aprobación previa de approve.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealSeed.
paymentAmount string | bigint Cantidad de tokens de pago a transferir (respetando minContribution).
await linealSeed.buy('0xSeedContractAddress...', '100000000'); // ej. 100 USDC (6 decimales)

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

Finaliza la venta una vez concluido el plazo (endTime) o alcanzado el hardCap. Activa el TGE y calcula si la ronda fue exitosa.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealSeed.
await linealSeed.finalize('0xSeedContractAddress...');

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

Reclama la porción de tokens de venta desbloqueada hasta la fecha según el calendario de vesting.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealSeed.
await linealSeed.claim('0xSeedContractAddress...');

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

Devuelve los fondos aportados al comprador si la ronda finalizó sin alcanzar el softCap.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealSeed.
await linealSeed.refund('0xSeedContractAddress...');

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

Transfiere la recaudación total en token de pago hacia LinealLiquidity (solo si la venta fue exitosa).

await linealSeed.withdrawFunds('0xSeedContractAddress...');

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

Retira los tokens no vendidos hacia la tesorería institucional, preservando la reserva de los compradores.

await linealSeed.withdrawUnsoldTokens('0xSeedContractAddress...');

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

Calcula la cantidad de tokens disponibles para reclamo inmediato de un comprador.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealSeed.
buyer string Dirección de la billetera del comprador.
const tokensToClaim = await linealSeed.claimable('0xSeedContractAddress...', '0xBuyerWallet...');
console.log('Tokens listos para reclamar:', tokensToClaim);

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

const bought = await linealSeed.purchased('0xSeedContractAddress...', '0xBuyerWallet...');
const paid = await linealSeed.contributed('0xSeedContractAddress...', '0xBuyerWallet...');
const alreadyClaimed = await linealSeed.claimed('0xSeedContractAddress...', '0xBuyerWallet...');

El módulo LinealTenders permite consultar la información de licitaciones públicas tokenizadas del protocolo Lineal Qorum. Las licitaciones son tokens NFT (ERC-721) respaldados por una subcuenta bancaria presupuestaria en el banco institucional y bases técnicas verificables on-chain.

  • Representación Tokenizada (ERC-721): Cada proceso licitatorio cuenta con su propio identificador único (tokenId), bases digitales inmutables (documentURL) y monto presupuestario asignado.
  • Subcuenta Bancaria Asociada: Al crearse una licitación mediante LinealInstitution.mintTender, se abre una subcuenta dedicada en LinealBank donde se reservan los fondos del proyecto.
  • Acceso y Auditoría Pública: Todos los métodos del módulo son consultas abiertas (view) accesibles para cualquier ciudadano o auditor externo.
import { linealTenders, LinealTenders } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:
// linealTenders.getTenders(...);
// O crear una nueva instancia:
const tenders = new LinealTenders();

Todos los métodos expuestos por LinealTenders en el SDK son consultas públicas de solo lectura (view):

Método Tipo de Ejecución Modificador On-Chain Endpoint SDK
getTender Normal (Lectura) view (público) /read-contract
getTenderCounter Normal (Lectura) view (público) /read-contract
subAccountOf Normal (Lectura) view (público) /read-contract
getTenderIds Normal (Lectura) view (público) /read-contract
getTenders Normal (Lectura) view (público) /read-contract
tokenURI Normal (Lectura) view (público) /read-contract

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

Obtiene la información detallada de una licitación a partir de su identificador numérico de token.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealTender.
tokenId number | string Identificador único del token NFT de la licitación.

Retorno: Promise<any> — Objeto con título, descripción, URI de imagen, URL de bases, monto asignado y subcuenta asociada.

const tender = await linealTenders.getTender(
'0xTendersContractAddress...',
1
);
console.log('Detalle de licitación:', tender);

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

Devuelve la cantidad total acumulada de licitaciones emitidas por la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealTender.

Retorno: Promise<any> — Contador numérico total.

const total = await linealTenders.getTenderCounter('0xTendersContractAddress...');
console.log('Total de licitaciones emitidas:', total);

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

Obtiene el identificador bytes32 de la subcuenta bancaria asociada a una licitación, desde donde se realizan los pagos a proveedores adjudicados.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealTender.
tokenId number | string Identificador único del token de la licitación.

Retorno: Promise<string> — Identificador bytes32 de la subcuenta en LinealBank.

const subAccountId = await linealTenders.subAccountOf(
'0xTendersContractAddress...',
1
);
console.log('Subcuenta bancaria del proyecto:', subAccountId);

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

Retorna un arreglo con todos los identificadores (tokenIds) de licitaciones activas o registradas en la institución.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealTender.

Retorno: Promise<any[]> — Lista de IDs numéricos de licitaciones.

const ids = await linealTenders.getTenderIds('0xTendersContractAddress...');
console.log('IDs de licitaciones:', ids);

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

Obtiene una lista paginada de licitaciones registradas.

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealTender.
offset number Índice inicial de paginación (desplazamiento).
limit number Cantidad máxima de registros a recuperar por consulta.

Retorno: Promise<any[]> — Arreglo de estructuras de licitaciones paginadas.

const page = await linealTenders.getTenders(
'0xTendersContractAddress...',
0, // offset
10 // límite (10 licitaciones)
);
console.log('Licitaciones paginadas:', page);

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

Retorna la URI con la metadata estándar ERC-721 del NFT de la licitación (incluyendo bases técnicas, descripción y presupuesto).

Argumentos:

Parámetro Tipo Descripción
contractAddress string Dirección hexadecimal (0x...) del contrato LinealTender.
tokenId number | string Identificador único del token NFT.

Retorno: Promise<string> — URI o data JSON de metadatos del NFT.

const uri = await linealTenders.tokenURI('0xTendersContractAddress...', 1);
console.log('Metadata URI:', uri);