Guía para desarrolladores
Sitio de VEX PayReferencia de API
Explorar documentación

Usa tu saldo USDT sin VEX Pay

Tu saldo USDT de VEX Pay es solo tuyo. Si VEX Pay no está disponible, mueve tu dinero con tu billetera de respaldo o tus contactos de recuperación, desde cualquier interfaz de Safe o directamente desde Polygonscan.

Tu saldo USDT no depende de VEX Pay

Tu saldo USDT («Saldo USDT» en la app) vive en una cuenta inteligente Safe en Polygon; en esta guía la llamamos tu billetera. Solo sus dueños pueden mover el dinero: la llave de acceso de tu teléfono (Face ID o huella) y, si agregaste una, tu billetera de respaldo. VEX Pay no tiene ninguna llave. No puede mover, congelar ni recuperar tu dinero, y no necesita estar en línea para que llegues a él.

La app se comunica con Polygon a través de VEX Pay, y tu llave de acceso solo funciona dentro de la app de VEX Pay y de wallet.vexpay.app. Si VEX Pay se cae o cierra, usas tu billetera de respaldo: también es dueña, aprueba sola y funciona desde cualquier interfaz compatible con cuentas Safe.

  • La dirección de tu billetera. Aparece en Saldo USDT. Anótala en un lugar seguro; también está en cualquier enlace de Polygonscan que abrió la app.
  • Tu billetera de respaldo. Cualquier billetera normal que controles, por ejemplo MetaMask o una billetera física, ya agregada como respaldo y con sus 24 horas cumplidas.
  • Un poco de POL en la billetera de respaldo. Sin VEX Pay nadie paga la comisión de la red por ti. Con 0,1 POL alcanza para muchas operaciones.
  • Polygon rechaza una propina de red muy baja. Pide al menos 25 gwei. MetaMask y Safe lo ponen solos; con un script (cast send), usa por ejemplo --priority-gas-price 30gwei --gas-price 60gwei.

Los límites siguen aplicando

Tu billetera tiene un contrato de límites de gasto (el guard) que te protege si te roban una llave. Vive en Polygon, no en VEX Pay, así que aplica en todas las interfaces y a todos los dueños, también a tu billetera de respaldo.

Lo que hacesCuándo ocurre
Enviar USDT a una dirección guardada y listaAl instante, cualquier monto
Enviar USDT a cualquier otra dirección, hasta US$200 por día (UTC) en totalAl instante
Enviar más que esoPonlo en cola y ejecútalo después de 1 hora, dentro de los 7 días siguientes
Cualquier otra cosa: agregar o quitar un dueño, cambiar el guard o un módulo, enviar POL u otros tokensPonlo en cola y ejecútalo después de 24 horas, dentro de los 7 días siguientes
Guardar una direcciónAl instante si la billetera nunca tuvo dinero; si no, queda lista después de 1 hora
Quitar una dirección guardada o cancelar algo en colaAl instante
  • Una operación fuera de estas reglas se rechaza con NotAllowedInstantly. Ponla en cola.
  • No se permiten reembolsos de comisión: safeTxGas, baseGas y gasPrice deben ser 0. La billetera de respaldo que envía paga la comisión en POL.
  • Cualquiera puede ejecutar una acción en cola cuando está lista. Solo un dueño puede ponerla en cola o cancelarla.

Paso 01

Opción A: una interfaz de Safe

Safe{Wallet} (app.safe.global) y otras interfaces compatibles con Safe pueden abrir tu billetera con tu billetera de respaldo conectada. VEX Pay no participa; puedes usar cualquier interfaz de confianza que admita cuentas Safe en Polygon.

  1. Conecta tu billetera de respaldo

    Abre la interfaz, conecta MetaMask (o tu billetera física) y elige la red Polygon.

  2. Agrega tu billetera como cuenta existente

    Usa «agregar una cuenta Safe existente» (o su equivalente) y pega la dirección de tu billetera. Verás como dueños tu llave de acceso y tu billetera de respaldo, con 1 confirmación requerida.

  3. Envía dentro de los límites

    Crea un envío de USDT a una dirección guardada, o dentro de los US$200 del día. Deja los campos avanzados de gas en 0 y ejecútalo tú mismo con la billetera de respaldo.

  4. Envíos mayores: primero en cola

    En el creador de transacciones de la interfaz, llama a queue(to, value, data, operation) en tu guard con to = el contrato de USDT, value = 0, data = el transfer de USDT (ver la siguiente sección) y operation = 0. Después de 1 hora, ejecútalo con executeQueued (paso 05).

Paso 02

Opción B: directamente desde Polygonscan

Esto funciona solo con polygonscan.com y tu billetera de respaldo. Como la billetera de respaldo envía la operación ella misma, no necesita aprobar un mensaje aparte: la billetera acepta la aprobación de quien envía.

  1. Abre tu billetera en Polygonscan

    Busca la dirección de tu billetera, abre Contract → Write as Proxy y pulsa Connect to Web3 con tu billetera de respaldo.

  2. Completa execTransaction

    Usa los valores de la tabla. Todo, salvo to y data, es un valor fijo.

  3. Envía y confirma

    Pulsa Write y confirma en tu billetera de respaldo. Ella paga la comisión en POL.

CampoValor
toEl contrato de USDT (0xc2132D05D31c914a87C6611C10748AEb04B58e8F), o tu guard para poner en cola
value0
dataLa llamada, ver la siguiente sección
operation0
safeTxGas, baseGas, gasPrice0
gasToken, refundReceiver0x0000000000000000000000000000000000000000
signatures0x + 24 ceros + la dirección de tu billetera de respaldo sin 0x + 64 ceros + 01

Esa firma significa «aprobado por quien envía»: los primeros 32 bytes son la dirección de tu billetera de respaldo, los 32 siguientes son cero y el último byte es 01. Solo funciona cuando esa misma billetera de respaldo envía la operación.

Paso 03

Arma la llamada

Un envío de USDT es transfer(destino, monto). USDT tiene 6 decimales, así que 50 USDT son 50000000. El dato es 0xa9059cbb, luego el destino sin 0x completado con ceros a la izquierda hasta 64 caracteres, y luego el monto en hexadecimal completado hasta 64 caracteres.

Ejemplo: 50 USDTbash
# destino 0x1111111111111111111111111111111111111111, monto 50000000 = 0x2faf080
0xa9059cbb
0000000000000000000000001111111111111111111111111111111111111111
0000000000000000000000000000000000000000000000000000000002faf080
# todo junto en una sola línea, sin espacios
Foundry (cast)bash
# sirve cualquier RPC pública de Polygon, por ejemplo https://polygon-bor-rpc.publicnode.com
cast calldata "transfer(address,uint256)" 0xDESTINO 50000000

# un envío mayor pasa por el guard: queue(USDT, 0, <dato del transfer>, 0)
cast calldata "queue(address,uint256,bytes,uint8)" 0xUSDT 0 0xDATO_TRANSFER 0

Para poner en cola, envía execTransaction con to = tu guard y data = la llamada queue(...). El guard registra cuándo queda lista (el evento Queued muestra executableAt).

Paso 04

Encuentra tu guard

Tu billetera guarda la dirección de su guard en una posición fija de su almacenamiento, así que puedes leerla desde cualquier nodo de Polygon sin VEX Pay. Los últimos 40 caracteres del resultado son la dirección del guard.

Foundry (cast)bash
cast storage 0xTU_BILLETERA 0x4a204f620c8c5ccdca3fd54d003badd85ba500436a431f0cbda4f558c93c34c8 \
  --rpc-url https://polygon-bor-rpc.publicnode.com

Paso 05

Ejecuta o cancela una acción en cola

  1. Espera a que esté lista

    1 hora para un envío de USDT, 24 horas para todo lo demás. Se puede ejecutar durante los 7 días siguientes; después, ponla en cola de nuevo.

  2. Ejecútala

    Abre tu guard en Polygonscan, Contract → Write Contract, y llama a executeQueued(safe, to, value, data, operation) con la dirección de tu billetera y exactamente los valores que pusiste en cola. Cualquier billetera puede enviarla; paga la comisión en POL.

  3. O cancélala

    Antes de que se ejecute, un dueño puede cancelarla: execTransaction con to = tu guard y data = cancel(actionHash). El actionHash está en el evento Queued, o lo da actionHash(safe, to, value, data, operation) en el guard.

Paso 06

Si perdiste a todos los dueños: contactos de recuperación

Cada billetera tiene activo un módulo de recuperación social de código abierto y auditado (Candide Social Recovery, 0x00480F5ecC008995469fA7e12c70Ef3DC9FEe7fD, la misma dirección en Polygon y Amoy). Si configuraste contactos de recuperación, ellos pueden reemplazar a los dueños de la billetera sin ti y sin VEX Pay. La app de VEX Pay todavía no permite agregar contactos de recuperación; mientras tanto, la salida es una billetera de respaldo.

  1. Los contactos confirman el nuevo dueño

    La cantidad requerida de contactos llama, cada uno, a confirmRecovery(wallet, newOwners, newThreshold, nonce, execute) en el módulo, con el mismo nuevo dueño (por ejemplo, una billetera nueva tuya) y umbral 1. El nonce sale de nonce(wallet) en el módulo. El último pone execute en true.

  2. Espera 3 días

    La espera permite que un dueño actual detenga una recuperación que no pidió.

  3. Termina

    Cualquiera llama a finalizeRecovery(wallet) en el módulo. Luego el nuevo dueño mueve el dinero como en las opciones A y B, con los mismos límites.

La recuperación no pasa por el guard, así que el guard nunca puede bloquearla. Para cancelar una recuperación que no pediste, un dueño pone en cola cancelRecovery() en el módulo (un cambio de seguridad, listo después de 24 horas) y lo ejecuta antes de que terminen los 3 días.

Direcciones

ContratoPolygonRed de prueba Amoy
USDT (aparece como USDT0 en Polygonscan)0xc2132D05D31c914a87C6611C10748AEb04B58e8F0xE1BBFB59127d003Ca8E5Fbbac142323239aB0026 (USDT de prueba)
GuardLéelo desde tu billetera (paso 04)0x160EdB17C5aa5055B2948D95552BF6ebaa0dc130
Módulo de recuperación (espera de 3 días)0x00480F5ecC008995469fA7e12c70Ef3DC9FEe7fD0x00480F5ecC008995469fA7e12c70Ef3DC9FEe7fD