Ідентифікатори

Нижче вказані наступні можливості роботи з ідентифікаторами:

• #create-identifiers

• переглянути #identifiers-history

• #delete-identifiers

До інформації:

1. операція створення та видалення ідентифікаторів потребує схвалення працівника з боку DCM

2. тільки 1 запит на створення або видалення ідентифікаторів може мати статус «створено».

Створення ідентифікатору(ів)

Щоб створити ідентифікатори, використовуйте цю кінцеву точку:

Issue asset

post

Issue asset

Path parameters

counterparty_guidstringRequired

Counterparty GUID

Body

amountnumberOptional

amount of issued assets

asset_codestringOptional

asset code that will be created

asset_issuerstringOptional

address in stellar which will issue token

reserve_balancenumberOptional

optional reserve balance

Responses

Responseobject

post

HTTPcURLJavaScriptPython

POST /api/v1/counterparty/{counterparty_guid}/emission/issue HTTP/1.1
Host: your_host
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "amount": 1,
  "asset_code": "text",
  "asset_issuer": "text",
  "reserve_balance": 1
}

{}

Має бути виконана умова:

$Reserve Acc Balance >= sum(create) - sum(delete) + X$

де:

• X - необхідну суму для створення

• sum(A) - історія всіх створених або видалених ідентифікаторів

Історія ідентифікатора(ів)

Щоб переглянути історію ідентифікатора, використовується наступний запит:

Assets history

get

Assets history

Path parameters

counterparty_guidstringRequired

Counterparty GUID

Query parameters

guidstringOptional

Emission GUID

directionstringOptional

Direction

balance_guidstringOptional

Balance GUID

asset_guidstringOptional

Asset GUID

issuer_payment_guidstringOptional

Issuer payment GUID

emission_payment_guidstringOptional

Emission payment GUID

issuer_payment_hashstringOptional

Issuer payment hash

emission_payment_hashstringOptional

Emission payment hash

statusstringOptional

Status

created_bystringOptional

Created by

updated_bystringOptional

Updated by

min_created_atstringOptional

Min created_at

max_created_atstringOptional

Max created_at

min_updated_atstringOptional

Min updated_at

max_updated_atstringOptional

Max updated_at

orderstring · enumOptional

Sorting order

Possible values:

offsetintegerOptional

Offset

limitintegerOptional

Limit

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/counterparty/{counterparty_guid}/emission/history HTTP/1.1
Host: your_host
Accept: */*

{
  "history": [
    {
      "balance": {
        "asset_guid": "text",
        "counterparty_guid": "text",
        "created_at": "text",
        "emission_account_guid": "text",
        "guid": "text",
        "reserve_balance_amount": 1,
        "updated_at": "text"
      },
      "created_at": "text",
      "created_by": "text",
      "direction": "text",
      "emission_payment_guid": "text",
      "emission_payment_hash": "text",
      "guid": "text",
      "issuer_payment_guid": "text",
      "issuer_payment_hash": "text",
      "requested_amount": 1,
      "reserve_balance_amount": 1,
      "status": "text",
      "updated_at": "text",
      "updated_by": "text"
    }
  ],
  "total": 1
}

Видалення ідентифікатору(ів)

Щоб видалити ідентифікатори, використовується наступний запит:

Burn asset

post

Burn asset

Path parameters

counterparty_guidstringRequired

Counterparty GUID

Body

amountnumberOptional

amount of tokens that will be burnt

asset_codestringOptional

asset's code

asset_issuerstringOptional

address in stellar that is the issuer address

reserve_balancenumberOptional

optional reserve balance

Responses

Responseobject

post

HTTPcURLJavaScriptPython

POST /api/v1/counterparty/{counterparty_guid}/emission/burn HTTP/1.1
Host: your_host
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "amount": 1,
  "asset_code": "text",
  "asset_issuer": "text",
  "reserve_balance": 1
}

{}

За домовленністю: Має бути виконана умова:

$Reserve Acc Balance >= sum(create) - sum(delete) - Y$

де:

• Y - запитану суму для видалення

• sum(A) - історія всіх створених або видалених ідентифікаторів