Implantando e adicionando um token extra

Tokens extras são tokens que não necessariamente foram adicionados pelo próprio PaySwap, eles podem ser tokens que representam ações, fundos de índice, commodities, moedas nativas de várias blockchains, etc.

Suponha que você queira configurar uma dRamp para ajudar usuários de todo o mundo a comprar ações da Tesla. Você pode implantar um token da Tesla como um token extra e adicioná-lo à sua dRamp para que os usuários possam criar ou destruir tokens da Tesla.

Nesse cenário, cada vez que um usuário cria tokens da Tesla, o valor equivalente em USD do número de tokens da Tesla é transferido para sua conta Stripe (no caso de dRamps automáticas) para que você possa comprar as ações reais da Tesla no mercado de ações.

Esse modelo pode ser usado para permitir que qualquer pessoa em todo o mundo tenha acesso a ações, fundos de índice, etc.

Você pode substituir a Tesla no exemplo acima por commodities como Ouro, Prata, Bitcoin, etc.

Implantação de um Token Extra

Para implantar um token extra, vá para o menu de controle de sua dRamp, clique no botão Implantar Token Extra

Preencha o formulário com o nome do token, seu ticker e uma versão stringified do objeto de chamada para uma API que retornará o preço do token em USD.

Suponhamos que você queira utilizar a API Alpha Vantage para obter o preço do token. Siga as instruções para criar o objeto de chamada à API. Uma vez que você tenha o objeto de chamada, copie-o e cole-o no campo "Objeto de Chamada" do formulário de implantação do token extra.

Certifique-se de que sua API retorne um valor que seja o preço do token em USD, ou uma série de valores no formato CSV, dos quais o primeiro número válido seja o preço do token em USD.

Uma vez que você tenha o objeto de chamada stringified, cole-o no campo "Objeto de Chamada" do formulário de implantação do token extra e valide a transação.

Assim que seu token for implantado, você deverá ver seu endereço listado na seção de parâmetros de sua dRamp como no exemplo abaixo, sob o campo Tokens Extras. Se não visualizá-lo, recarregue a página.

Copie o endereço clicando no ícone ao lado dele e volte para o painel de controle da sua dRamp.

Selecione o botão Adicionar Token Extra, cole o endereço previamente copiado no campo Endereço do Token Extra e valide a transação.

O próximo passo é adicionar esse token recém-criado como um mercado de token para que os usuários possam criar ou destruir o token.

Adicionando um Token Extra

Para adicionar seu novo token como um mercado de token para que os usuários possam criar ou destruir, vá para o menu de controle de sua dRamp, clique no botão Adicionar Mercado de Token e valide o formulário.

Você deverá ver seu token adicionado na seção inferior esquerda do painel de sua dRamp, como no exemplo abaixo.

Para permitir que os usuários criem ou destruam seu novo token, você também deve configurar sua dRamp para buscar seu preço na API.

Selecione o token, clique no botão Painel de Controle, e no menu, clique no botão Obter Preço da API. Atualize até obter um número real e não um NaN.

A plataforma utiliza sua API para obter o preço do token em USD e, em seguida, converte seu preço em USD para o da moeda nativa da blockchain de sua dRamp. Clique no botão Definir Preços e, em seguida, no botão Continuar. Valide a transação.

Você deverá ver o preço atualizado na seção de parâmetros de sua dRamp, como no exemplo abaixo.

O último passo é criar uma recompensa e anexá-la ao seu novo mercado de token para que os usuários possam começar a criar ou destruir seus tokens.

Certifique-se de que, quando o fizerem, você realmente vá e compre as ações reais da Tesla, caso contrário, sua recompensa poderá ser reclamada.

Encontrando uma API

Você pode encontrar várias APIs que retornam o preço em tempo real da maioria dos ativos fazendo uma simples pesquisa no Google.

A API fornecida no exemplo acima é a API Alpha Vantage da Rapid API. O site fornece instruções sobre como consultar os preços de várias ações, criptomoedas, moedas FIAT, etc.

Para consultar o preço de uma ação, por exemplo, use o objeto de chamada abaixo:

const options = {
  method: 'GET',
  url: 'https://alpha-vantage.p.rapidapi.com/query',
  params: {
    function: 'TIME_SERIES_DAILY',
    symbol: 'MSFT',
    outputsize: 'compact',
    datatype: 'csv'
  },
  headers: {
    'X-RapidAPI-Key': <sua_chave_privada>,
    'X-RapidAPI-Host': 'alpha-vantage.p.rapidapi.com'
  }
};

Este chamado retornará os preços diários da ação da MSFT em formato CSV (certifique-se de substituir your_private_key pela sua chave privada, que você pode obter criando uma conta no site).

Substituir o ticker da MSFT por qualquer outro ticker, como OZ (para Ouro), TSLA, bem como qualquer outra ação suportada pela API, retornará os preços dessa ação.

Um chamado com o objeto acima retornará um objeto CSV com o formato abaixo

timestamp,open,high,low,close,volume 
2024-01-22,400.0200,400.6200,393.5900,396.5100,27016902 
2024-01-19,395.7600,398.6700,393.5000,398.6700,29331136 
2024-01-18,391.7200,393.9900,390.1200,393.8700,23392068

O PaySwap analisa o primeiro número válido retornado no CSV, que neste caso é o preço de abertura da ação: 400.0200.

Se sua API retornar um conjunto diferente de respostas, apenas certifique-se de que o objeto retornado esteja no formato CSV e que o primeiro número válido seja o preço do ativo.

Adicionando Tags Relevantes

Recomendamos que você adicione tags à sua rampa relevantes para suas características, como os mercados de tokens que você adicionou a ela.

Se você adicionar a tag XOF à sua rampa, por exemplo, os usuários que procurarem criar ou destruir tokens tXOF/XOF poderão encontrar sua rampa muito mais rapidamente filtrando pela tag XOF no menu suspenso de Tags de Produto no topo da página das Ramps.

Para adicionar uma tag à sua rampa, vá para o menu de controle da sua rampa e selecione a opção Atualizar Localização

Digite a tag e valide a operação. Você também pode adicionar tags de localização selecionando os países relevantes e depois as cidades em que você opera nos menus suspensos de País e Cidade.