Copy page

Conceptos clave

Identificadores únicos de activos (UAI)

¿Qué son los Unique Asset IDs?

Los Unique Asset IDs (UAI) son identificadores estandarizados utilizados en el protocolo NASPIP y en la API de Fluxis para identificar de forma única tokens o activos de criptomonedas específicos en distintas redes blockchain. Cada UAI representa un par concreto de red y token, lo que garantiza una identificación precisa en entornos multichain.

Para más detalles, consulte la especificación de Unique Asset ID en la documentación de NASPIP.

Los UAI siguen un formato consistente que facilita identificar tanto la red blockchain como el token o activo específico al que se hace referencia. Este sistema también puede ampliarse para admitir monedas fiat y otros métodos de pago tradicionales.

Estructura del formato UAI

El formato UAI sigue este patrón:

Code
n[network]_t[token_address_or_symbol]

Donde:

• El prefijo n indica "network" (red)
• [network] es el identificador de la red blockchain
• El separador _t indica "token"
• [token_address_or_symbol] es la dirección del contrato del token o el símbolo nativo

Ejemplos:

• npolygon_t0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 - USDC en Polygon
• nerc20_t0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 - USDC en Ethereum

Activos admitidos

Fluxis admite actualmente los siguientes Unique Asset IDs en múltiples redes blockchain:

Red Ethereum

UAI	Network	Token	Symbol	Decimals
nerc20_t0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48	Ethereum	USDC	USDC	6
nerc20_t0xdAC17F958D2ee523a2206206994597C13D831ec7	Ethereum	USDT	USDT	6
nerc20_t0x0DC4F92879B7670e5f4e4e6e3c801D229129D90D	Ethereum	wARS	wARS	18
nerc20_t0xD76f5Faf6888e24D9F04Bf92a0c8B921FE4390e0	Ethereum	wBRL	wBRL	18
nerc20_t0x337E7456B420bD3481e7FA61fA9850343d610d34	Ethereum	wMXN	wMXN	18
nerc20_t0x8a1D45e102e886510e891d2Ec656a708991e2D76	Ethereum	wCOP	wCOP	18
nerc20_t0x4F34c8b3b5FB6D98Da888F0feA543d4d9C9F2eBE	Ethereum	wPEN	wPEN	18
nerc20_t0x61D450a098b6a7f69fC4b98CE68198fe59768651	Ethereum	wCLP	wCLP	18

Polygon PoS

UAI	Network	Token	Symbol	Decimals
npolygon_t0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359	Polygon PoS	USDC	USDC	6
npolygon_t0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174	Polygon PoS	USDC.e	USDC.e	6
npolygon_t0xc2132D05D31c914a87C6611C10748AEb04B58e8F	Polygon PoS	USDT	USDT	6
npolygon_t0x0DC4F92879B7670e5f4e4e6e3c801D229129D90D	Polygon PoS	wARS	wARS	18
npolygon_t0xD76f5Faf6888e24D9F04Bf92a0c8B921FE4390e0	Polygon PoS	wBRL	wBRL	18
npolygon_t0x337E7456B420bD3481e7FA61fA9850343d610d34	Polygon PoS	wMXN	wMXN	18

Arbitrum One

UAI	Network	Token	Symbol	Decimals
narbitrum_t0xaf88d065e77c8cC2239327C5EDb3A432268e5831	Arbitrum One	USDC	USDC	6
narbitrum_t0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9	Arbitrum One	USDT	USDT	6

Optimism

UAI	Network	Token	Symbol	Decimals
noptimism_t0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85	Optimism	USDC	USDC	6
noptimism_t0x7F5c764cBc14f9669B88837ca1490cCa17c31607	Optimism	USDC.e	USDC.e	6
noptimism_t0x94b008aA00579c1307B0EF2c499aD98a8ce58e58	Optimism	USDT	USDT	6

Base

UAI	Network	Token	Symbol	Decimals
nbase_t0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913	Base	USDC	USDC	6
nbase_t0xf016413834E6D1A14F3D628B11D6Ef725a6bdbDD	Base	ARGt	ARGt	18
nbase_t0x0DC4F92879B7670e5f4e4e6e3c801D229129D90D	Base	wARS	wARS	18
nbase_t0xD76f5Faf6888e24D9F04Bf92a0c8B921FE4390e0	Base	wBRL	wBRL	18
nbase_t0x337E7456B420bD3481e7FA61fA9850343d610d34	Base	wMXN	wMXN	18
nbase_t0x8a1D45e102e886510e891d2Ec656a708991e2D76	Base	wCOP	wCOP	18
nbase_t0x61D450a098b6a7f69fC4b98CE68198fe59768651	Base	wCLP	wCLP	18

BNB Smart Chain

UAI	Network	Token	Symbol	Decimals
nbep20_t0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d	BNB Smart Chain	USDC	USDC	18
nbep20_t0x55d398326f99059fF775485246999027B3197955	BNB Smart Chain	USDT	USDT	18
nbep20_t0x0DC4F92879B7670e5f4e4e6e3c801D229129D90D	BNB Smart Chain	wARS	wARS	18
nbep20_t0xD76f5Faf6888e24D9F04Bf92a0c8B921FE4390e0	BNB Smart Chain	wBRL	wBRL	18
nbep20_t0x337E7456B420bD3481e7FA61fA9850343d610d34	BNB Smart Chain	wMXN	wMXN	18
nbep20_t0x8a1D45e102e886510e891d2Ec656a708991e2D76	BNB Smart Chain	wCOP	wCOP	18

Avalanche C-Chain

UAI	Network	Token	Symbol	Decimals
navalanche_t0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E	Avalanche C-Chain	USDC	USDC	6
navalanche_t0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7	Avalanche C-Chain	USDT	USDT	6
navalanche_t0x2E4e93eCA2E16E4989b894e188B7F7fC0175703B	Avalanche C-Chain	ARGt	ARGt	18

Tron

UAI	Network	Token	Symbol	Decimals
ntrc20_tTR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t	Tron	USDT	USDT	6

Uso en NASPIP

Los UAI se utilizan en todo el protocolo NASPIP para especificar exactamente qué activo debe usarse para un pago. Al crear solicitudes de pago, especificará el UAI para indicar:

1. Qué red blockchain utilizar para la transacción
2. Qué token específico debe transferirse
3. La precisión decimal para los cálculos de importe

Ejemplo de uso

Code
POST /v1/pos/{posID}/payment-request
{
  "reference_id": "order-12345",
  "amount": "100",
  "unique_asset_id": "npolygon_t0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
  "order": {
    "total": "100",
    "coin_code": "USD",
    "description": "Payment for services"
  }
}

Soporte de monedas fiat

Si bien la implementación actual se centra en activos de criptomonedas, el formato UAI puede ampliarse para admitir monedas fiat. Las implementaciones futuras podrían incluir identificadores como:

• nfiat_tUSD - Dólar estadounidense
• nfiat_tEUR - Euro
• nfiat_tGBP - Libra esterlina

Recursos adicionales

Para obtener información técnica más detallada sobre los Unique Asset IDs y su implementación en el protocolo NASPIP, consulte la documentación oficial:

📚 Documentación NASPIP UAI

Notas de integración

Al integrarse con la API de Fluxis:

1. Utilice siempre la cadena UAI exacta tal como se proporciona en las tablas anteriores
2. Considere la precisión decimal al formatear importes
3. Valide la compatibilidad del UAI antes de crear solicitudes de pago
4. Manténgase actualizado sobre nuevas incorporaciones de UAI a medida que ampliamos el soporte de redes