Saltar al contenido principal

Activos y Clientes de Billeteras

Esta guía explica cómo configurar activos y clientes de billeteras en la Anchor Platform.

Configuración de Activos​

Los activos definen los tokens y monedas que tu Anchor Platform admite para depósitos y retiros. En la guía "Empezando", los activos se configuran en el archivo config/assets.yaml mediante el ap_start.sh.

Para la lista completa de campos y valores predeterminados, consulta la referencia de configuración de activos.

Ejemplo de Configuración de Activos​

items:
  - id: stellar:native
    distribution_account: "G...DIST"
    significant_decimals: 7
    sep6:
      enabled: true
      deposit:
        enabled: true
        min_amount: 0
        max_amount: 10
        methods:
          - SEPA
          - SWIFT
      withdraw:
        enabled: true
        min_amount: 0
        max_amount: 10
        methods:
          - bank_account
          - cash
    sep24:
      enabled: true
    sep31:
      enabled: true
    sep38:
      enabled: true
      exchangeable_assets:
        - iso4217:USD

Explicación de Campos​

  • id (Obligatorio) - El identificador del activo en el formato SCHEMA:CÓDIGO:(EMISOR) o stellar:native que representa XLM, el activo nativo de Stellar. Por ejemplo, stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5 representa Circle USD. Para monedas fiduciarias, usa iso4217:CÓDIGO (por ejemplo, iso4217:USD, iso4217:CAD).

  • distribution_account - La dirección de la cuenta Stellar que posee el activo para distribución. No es necesario para activos fiduciarios (iso4217).

  • significant_decimals - El número de decimales que admite el activo.

  • sep6 - Habilita SEP-6 y configura límites y métodos de depósito/retiro por activo.

  • sep24 - Habilita los flujos interactivos SEP-24 y sus configuraciones por activo.

  • sep31 - Habilita el soporte de pagos transfronterizos SEP-31 para el activo.

  • sep38 - Habilita cotizaciones SEP-38 y exchangeable_assets para pares de divisas admitidos.

Configuración de Clientes de Billeteras​

Los clientes de billetera son las apps de billetera que se conectan a tu Anchor Platform para realizar transacciones en nombre de los usuarios.

Para la lista completa de campos y valores predeterminados de clientes, consulta la referencia de configuración de clientes.

Ejemplo de Configuración de Cliente​

items:
  - name: "referenceCustodial"
    type: custodial
    signing_keys:
      - GDJLB...KLTG
    callback_urls:
      sep6: https://client.example.com/callbacks/sep6
      sep24: https://client.example.com/callbacks/sep24
      sep31: https://client.example.com/callbacks/sep31
      sep12: https://client.example.com/callbacks/sep12
  - name: "reference"
    type: noncustodial
    domains:
      - wallet-server:8092
      - client.example.com
    callback_urls:
    ...

Explicación de Campos​

Configuración de Cliente Custodial:

  • name (Obligatorio) - Un identificador único para el cliente.

  • type: custodial (Obligatorio) - El tipo de cliente. Debe establecerse en custodial para clientes custodial.

  • signing_keys (Obligatorio) - Una lista de claves públicas Stellar usadas para la autenticación SEP-10 del cliente. El anchor usa estas claves para verificar que las solicitudes provienen del cliente autorizado.

  • callback_urls (Opcional) - URLs a las cuales el servicio puede enviar callbacks para diferentes tipos SEP.

    • sep6 - URL de callback para actualizaciones del estado de transacciones SEP-6 (depósito/retiro)
    • sep24 - URL de callback para actualizaciones del estado de transacciones SEP-24 (depósito/retiro interactivo)
    • sep31 - URL de callback para actualizaciones del estado de transacciones SEP-31 (pagos transfronterizos)
    • sep12 - URL de callback para actualizaciones de información de cliente SEP-12 (KYC)

Configuración de Cliente No Custodial:

  • name (Obligatorio) - Un identificador único para el cliente, similar a clientes custodial. Normalmente un nombre que representa claramente a la entidad cliente.

  • type: noncustodial (Obligatorio) - El tipo de cliente. Debe establecerse en noncustodial para clientes no custodial. Los clientes no custodial permiten a los usuarios controlar sus propias claves privadas, y la billetera actúa como interfaz para cuentas controladas por el usuario.

  • domains (Obligatorio) - Una lista de dominios asociados con el cliente, usados para verificar la identidad del cliente.

  • callback_urls (Opcional) - URLs a las cuales el servicio puede enviar callbacks para diferentes tipos SEP. Funciona igual que para clientes custodial (ver arriba).