Primeros Pasos
⏱ 33 min de lectura
Instalación
Section titled “Instalación”npm install @linealqorum/react-native-sdkConfiguración en Aplicación Federada
Section titled “Configuración en Aplicación Federada”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.LinealInstitution
Section titled “LinealInstitution”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.
Utilización Básica
Section titled “Utilización Básica”import { linealInstitution, LinealInstitution } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:// linealInstitution.getSubAccounts(...);
// O crear una nueva instancia:const institution = new LinealInstitution();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 |
|---|---|---|---|
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 |
Configuración y Mantenimiento
Section titled “Configuración y Mantenimiento”setTokenSupport
Section titled “setTokenSupport”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);setPairToken
Section titled “setPairToken”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...');setCitizensAddress
Section titled “setCitizensAddress”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...');Gestión de Subcuentas y Fondos
Section titled “Gestión de Subcuentas y Fondos”createSubAccount
Section titled “createSubAccount”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');moveFundsToSubAccount
Section titled “moveFundsToSubAccount”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');moveFundsToBank
Section titled “moveFundsToBank”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');releaseFromBank
Section titled “releaseFromBank”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');releasePreSale
Section titled “releasePreSale”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');Licitaciones Tokenizadas
Section titled “Licitaciones Tokenizadas”mintTender
Section titled “mintTender”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');Identidad y Reputación Ciudadana
Section titled “Identidad y Reputación Ciudadana”mintProfile
Section titled “mintProfile”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...');updateIdentityScore
Section titled “updateIdentityScore”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);setProfileImageURI
Section titled “setProfileImageURI”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...');setDescription
Section titled “setDescription”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');Consultas y Vistas (Lectura)
Section titled “Consultas y Vistas (Lectura)”Métodos de consulta de solo lectura (view).
getDirectiva
Section titled “getDirectiva”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);getSubAccounts
Section titled “getSubAccounts”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...');getInstitutionBank
Section titled “getInstitutionBank”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...');getInstitutionTender
Section titled “getInstitutionTender”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...');getIdentity
Section titled “getIdentity”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...');getRewardsAccountId
Section titled “getRewardsAccountId”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...');getBankTokens
Section titled “getBankTokens”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...');getAccountBalances
Section titled “getAccountBalances”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);LinealBank
Section titled “LinealBank”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.
Principios y Soberanía de Fondos
Section titled “Principios y Soberanía de Fondos”- 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.
Uso Mínimo
Section titled “Uso Mínimo”import { linealBank, LinealBank } from '@linealqorum/react-native-sdk';
// Usar la instancia exportada singleton:// linealBank.accountBalancesAll(...);
// O crear una nueva instancia:const bank = new LinealBank();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 |
|---|---|---|---|
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 |
Operaciones Transaccionales (Escritura)
Section titled “Operaciones Transaccionales (Escritura)”Métodos ejecutados directamente por la billetera del usuario a través de transacciones estándar (/send-transaction).
deposit
Section titled “deposit”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);releaseFromMyAccount
Section titled “releaseFromMyAccount”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');moveFromMyAccount
Section titled “moveFromMyAccount”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');individualTransferToBank
Section titled “individualTransferToBank”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');Consultas y Vistas (Lectura)
Section titled “Consultas y Vistas (Lectura)”Métodos de consulta de solo lectura (view) a través de /read-contract.
isTokenSupported
Section titled “isTokenSupported”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);accountOf
Section titled “accountOf”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);accountBalance
Section titled “accountBalance”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);accountBalancesAll
Section titled “accountBalancesAll”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);tokenList
Section titled “tokenList”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);totalReserveBalance
Section titled “totalReserveBalance”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);LinealCitizens
Section titled “LinealCitizens”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.
Sistema de Identidad y Reputación
Section titled “Sistema de Identidad y Reputació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();Tabla Resumen de Métodos y Permisos
Section titled “Tabla Resumen de Métodos y Permisos”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 |
Consultas de Identidad
Section titled “Consultas de Identidad”getProfile
Section titled “getProfile”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"// }getProfileByToken
Section titled “getProfileByToken”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);getTokenCounter
Section titled “getTokenCounter”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);getReputation
Section titled “getReputation”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}`);subAccountOf
Section titled “subAccountOf”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);tokenURI
Section titled “tokenURI”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.
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...');LinealLiquidity
Section titled “LinealLiquidity”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).
Mecanismos Principales
Section titled “Mecanismos Principales”- Í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();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 |
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 |
Control Operativo (Pausa)
Section titled “Control Operativo (Pausa)”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...');unpause
Section titled “unpause”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...');Rondas de Financiamiento y Venta
Section titled “Rondas de Financiamiento y Venta”launchSeed
Section titled “launchSeed”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...');launchPreSeed
Section titled “launchPreSeed”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);withdrawUnsoldTokens
Section titled “withdrawUnsoldTokens”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...');Desbloqueo y Emisión Monetaria
Section titled “Desbloqueo y Emisión Monetaria”unlockAndMint
Section titled “unlockAndMint”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);LinealMilestones
Section titled “LinealMilestones”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.
El Índice de Desempeño (IDP)
Section titled “El Índice de Desempeño (IDP)”- 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();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 |
|---|---|---|---|
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 |
Propuesta y Gobernanza de Hitos
Section titled “Propuesta y Gobernanza de Hitos”createMilestone
Section titled “createMilestone”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));cancelMilestone
Section titled “cancelMilestone”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);Votación y Cierre de Hitos
Section titled “Votación y Cierre de Hitos”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);finalize
Section titled “finalize”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);Consultas de Desempeño
Section titled “Consultas de Desempeño”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);milestonesCount
Section titled “milestonesCount”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);LinealRouter
Section titled “LinealRouter”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).
Distribución de Ingresos y Tokenomics
Section titled “Distribución de Ingresos y Tokenomics”- 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
bpsValuesdebe ser exactamente igual a 10.000 (100%). - Ejecución Central: El método
distributeRevenuereparte 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();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 |
|---|---|---|---|
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 |
Configuración y Mantenimiento
Section titled “Configuración y Mantenimiento”setFeeSplitter
Section titled “setFeeSplitter”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...');setDistribution
Section titled “setDistribution”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']);pause / unpause
Section titled “pause / unpause”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...');Operación de Distribución
Section titled “Operación de Distribución”distributeRevenue
Section titled “distributeRevenue”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);Consultas de Receptores
Section titled “Consultas de Receptores”getRecipientsCount
Section titled “getRecipientsCount”Tipo de Ejecución:
Normal(view) · Endpoint:/read-contract
const count = await linealRouter.getRecipientsCount('0xRouterContractAddress...');console.log('Cantidad de receptores:', count);getAllRecipients
Section titled “getAllRecipients”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);LinealSeed
Section titled “LinealSeed”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.
Estructura de Vesting y Financiamiento
Section titled “Estructura de Vesting y Financiamiento”- 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 conwithdrawFunds. - 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();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 |
|---|---|---|---|
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)finalize
Section titled “finalize”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...');refund
Section titled “refund”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...');Operaciones Administrativas
Section titled “Operaciones Administrativas”withdrawFunds
Section titled “withdrawFunds”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...');withdrawUnsoldTokens
Section titled “withdrawUnsoldTokens”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...');Consultas de Estado y Vesting
Section titled “Consultas de Estado y Vesting”claimable
Section titled “claimable”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);purchased / contributed / claimed
Section titled “purchased / contributed / claimed”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...');LinealTenders
Section titled “LinealTenders”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.
Arquitectura de Licitaciones
Section titled “Arquitectura de Licitaciones”- 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 enLinealBankdonde 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();Tabla Resumen de Métodos y Permisos
Section titled “Tabla Resumen de Métodos y Permisos”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 |
Consultas de Licitaciones
Section titled “Consultas de Licitaciones”getTender
Section titled “getTender”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);getTenderCounter
Section titled “getTenderCounter”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);subAccountOf
Section titled “subAccountOf”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);getTenderIds
Section titled “getTenderIds”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);getTenders
Section titled “getTenders”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);tokenURI
Section titled “tokenURI”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);