Criando um ativo e transferindo ele entre carteiras

A Plataforma 2Ledger simplifica e acelera a adoção da tecnologia blockchain em seus negócios. Integrar com ela é super simples basta criar uma conta e começar a utilizar a sua API.

A API foi toda desenvolvida seguindo os princípios do padrão RESTful e permite a integração com praticamente todas as linguagens de programação mais modernas.

O primeiro passo é criar a sua conta na 2Ledger. Caso ainda não tenha realizado poderá fazê-lo clicando aqui.

Autenticação

O primeiro passo para utilizar a API é obter o token que será utilizado em todas as interações com a plataforma. A autenticação da plataforma 2Ledger utiliza o padrão Basic Access Authentication. Para realizar a autenticação basta fazer a seguinte requisição:

//Credentials (login:password) in base64 format

var credentials = "bWFyY2lvQDJsZWRnZXsuY28tOkNnN2RuaHh0";

$.ajax({

   url: "https://api.2ledger.com/v1/login",
   method: "post",
   beforeSend: function(request) {
       request.setRequestHeader("Accept", "application/json");
       request.setRequestHeader("Authorization", "Basic " + credentials);
   },
   success: function( result ) {
       var token = result.response;
       console.log(token);
   },
   error: function (err) {
       console.log("Authentication failed: " + err.responseJSON, err);
   }

});

O header Authorization é o resultado da combinação login:password em formato Base64 e se passado corretamente retorna o token como resposta.

No caso da autenticação falhar um erro http 400 será retornado. Verifique novamente as credenciais informadas e tente novamente.

Autorização

Todas as operações de interação com a API da Plataforma 2Ledger implementam o padrão Bearer Token e exigem o token retornado no tópico anterior no header Authorization de cada requisição.

//Add an authorization header into request
request.setRequestHeader("Authorization", "Bear " + token);

Caso o token informado não seja válido um erro http 401 Unauthorized será retornado informando a necessidade de um token válido. Nesse caso retorne ao tópico anterior para obter um token válido.

Criação de uma rede

Todas as operações realizadas na plataforma 2Ledger dizem respeito a alguma rede criada entre seus participantes para interagirem entre si. Caso essa rede ainda não tenha sido criada ela poderá ser criada conforme requisição a seguir informando um nome para a rede e a sua descrição.

//Token created during login
var token = "my token";

$.ajax({
       url: "https://api.2ledger.com/v1/networks",
       method: "post",
       beforeSend: function(request) {
           request.setRequestHeader("Accept", "application/json");
           request.setRequestHeader("Authorization", "Bearer " + token);
       },
       data: { name: "mynetwork", description: "Network test" },
       success: function( result ) {
           console.log(result);
       },
       error: function (err) {
           console.log("Error: " + err.responseJSON, err);
       }
});

Caso a rede seja criada com sucesso a requisição irá retornar o código 200 e um objeto JSON com o metadado da rede criada. A propriedade “response._id” do objeto retornado define a identificação única da rede a ser utilizado posteriormente ao interagir com ela.

Caso a requisição para a criação da rede falhe um retorno http 400 Bad Request será retornado.

Criação de um ativo

Um dos principais diferenciais da tecnologia blockchain é a possibilidade de gestão descentralizada de ativos, ou seja, permite que um recurso financeiro ou bem possa ser administrado digitalmente. Sem a possibilidade de uma propriedade/ativo ser transferido de portador sem a autorização de seu proprietário.

Este recurso tecnológico foi o responsável pelo surgimento de uma infinidade de criptomoedas, entre elas o Bitcoin, mas esse recurso pode ser utilizado para vários outras finalidades como sistemas de votação, rastreamento de produção, controle da posse de terras entre outros. Com a Plataforma 2Ledger é muito simples e em poucos passos você poderá criar o seu próprio ativo.

O primeiro passo para criar uma ativo é realizar uma requisição conforme descrito a seguir informando o identificador da rede onde o ativo será criado (obtida no momento da criação da rede), um nome para o ativo, a quantidade de ativos emitidos inicialmente, a sua precisão (quantidade de casas decimais) e uma descrição:

//creating an asset

var token = "my token";
var network = '5b47e81ecd80440038702153';

$.ajax({
       url: "https://api.2ledger.com/v1/networks/"+network+"/assets",
       method: "post",
       beforeSend: function(request) {
           request.setRequestHeader("Accept", "application/json");
           request.setRequestHeader("Authorization", "Bearer " + token);
       },
       data: { 
         name: "mycoin", 
         qty: 1000000, 
         precision: 0.01, 
         details: "My test coin" } },
       success: function( result ) {
           console.log(result);
       },
       error: function (err) {
           console.log("Error: " + err.responseJSON, err);
       }
 });

Caso o ativo tenha sido criado com sucesso a requisição irá retornar o código 200 e um objeto JSON com o metadado da entidade criada. A propriedade “response.owner” do objeto retornado define a identificação da carteira onde o recurso foi depositado inicialmente e o a propriedade “response._id” a sua identificação.

Criação de carteiras digitais

É por meio de carteiras digitais que os usuários da Plataforma 2Ledger podem transmitir seus ativos. Para criar uma carteira digital é necessário realizar uma requisição para a API conforme demontrado abaixo.

//creating a wallet
var token = "my token";
var network = '5b47e81ecd80440038702153';

$.ajax({
       url: "https://api.2ledger.com/v1/networks/"+network+"/wallets",
       method: "post",
       beforeSend: function(request) {
           request.setRequestHeader("Accept", "application/json");
           request.setRequestHeader("Authorization", "Bearer " + token);
       },
       success: function( result ) {
           console.log(result);
       },
       error: function (err) {
           console.log("Error: " + err.responseJSON, err);
       }
});

Caso a carteira digital tenha sido criada com sucesso a requisição irá retornar o código 200 e um objeto JSON com o metadado da carteira digital criada. A propriedade “response.address” do objeto retornado define o endereço da carteira.

Para efeitos de demonstração foi escolhida uma forma de criação de carteiras digitais que não exige senha para a sua manipulação. Este recurso deverá ser utilizado apenas quanto a camada de segurança do acesso à carteira ficará no aplicativo que está integrando à Plataforma.

Outras formas de carteiras digitais podem ser criadas na plataforma. Caso tenha necessidade de conhecê-las acesse a documentação completa da API em https://api.2ledger.com/docs.

Transferência de um ativo

A transferência de um ativo de uma rede é realizada a partir de um carteria digital que a possui para uma outra carteira digital. A transferência do ativo poderá ser integral ou fracionada conforma a precisão definida no momento da criação do ativo.

A carteira digital para onde o recurso será transferido poderá ser tanto uma carteira criada por um usuário como para a carteira digital criada por um outro usuário participante da rede.

//creating a wallet
var token = "my token";
var network = '5b47e81ecd80440038702153';

$.ajax({
       url: "https://api.2ledger.com/v1/networks/"+network+"/wallets",
       method: "post",
       beforeSend: function(request) {
           request.setRequestHeader("Accept", "application/json");
           request.setRequestHeader("Authorization", "Bearer " + token);
       },
       success: function( result ) {
           console.log(result);
       },
       error: function (err) {
           console.log("Error: " + err.responseJSON, err);
       }
 });

 

Caso a carteira digital tenha sido criada com sucesso a requisição irá retornar o código 200 e um objeto JSON com o metadado da carteira digital criada. A propriedade “response.address” do objeto retornado define o endereço da carteira.

Considerações finais

O objetivo deste documento é apresentar ao usuário da plataforma 2Ledger os primeiros passos para a utilização de sua API, especificamente para a criação de um criptoativo e a sua transferência entre carteiras.

Mais informações sobre a utilização da plataforma 2Ledger e sua API podem ser encontrados na área administrativa acessível em https://admin.2ledger.com.

Deixe um comentário

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair /  Alterar )

Foto do Google

Você está comentando utilizando sua conta Google. Sair /  Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair /  Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair /  Alterar )

Conectando a %s