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 retiradas de fondos. En la guía "Comenzar", los activos se configuran en el archivo config/assets.yaml mediante el ap_start.sh.

Para la lista completa de campos y valores por defecto, 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:CODE:(ISSUER) o stellar:native que representa XLM, el activo nativo de Stellar. Por ejemplo, stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5 representa Circle USD. Para monedas fiat, usa iso4217:CODE (por ejemplo, iso4217:USD, iso4217:CAD).

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

  • significant_decimals - La cantidad de decimales que el activo admite.

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

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

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

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

Configuración de Clientes de Billeteras​

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

Para la lista completa de campos y valores por defecto de los 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 custodiales.

  • 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 que el servicio puede enviar callbacks para diferentes tipos SEP.

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

Configuración de Cliente No Custodial:

  • name (Obligatorio) - Un identificador único para el cliente, similar al de clientes custodiales. Típicamente un nombre que representa claramente la entidad cliente.

  • type: noncustodial (Obligatorio) - El tipo de cliente. Debe establecerse en noncustodial para clientes no custodiales. Los clientes no custodiales 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, usada para verificar su identidad.

  • callback_urls (Opcional) - URLs a las que el servicio puede enviar callbacks para diferentes tipos SEP. Funciona de la misma manera que para clientes custodiales (ver arriba).