curl --request POST \
--url https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request \
--header 'Content-Type: application/json' \
--data '
{
"holder": "<string>",
"holdingContractIds": [
"<string>"
],
"instrumentId": {
"admin": "<string>",
"id": "<string>"
}
}
'import requests
url = "https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request"
payload = {
"holder": "<string>",
"holdingContractIds": ["<string>"],
"instrumentId": {
"admin": "<string>",
"id": "<string>"
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
holder: '<string>',
holdingContractIds: ['<string>'],
instrumentId: {admin: '<string>', id: '<string>'}
})
};
fetch('https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'holder' => '<string>',
'holdingContractIds' => [
'<string>'
],
'instrumentId' => [
'admin' => '<string>',
'id' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request"
payload := strings.NewReader("{\n \"holder\": \"<string>\",\n \"holdingContractIds\": [\n \"<string>\"\n ],\n \"instrumentId\": {\n \"admin\": \"<string>\",\n \"id\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request")
.header("Content-Type", "application/json")
.body("{\n \"holder\": \"<string>\",\n \"holdingContractIds\": [\n \"<string>\"\n ],\n \"instrumentId\": {\n \"admin\": \"<string>\",\n \"id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"holder\": \"<string>\",\n \"holdingContractIds\": [\n \"<string>\"\n ],\n \"instrumentId\": {\n \"admin\": \"<string>\",\n \"id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"factoryId": "<string>",
"choiceContext": {
"choiceContextData": {},
"disclosedContracts": [
{
"contractId": "<string>",
"templateId": "<string>",
"createdEventBlob": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"synchronizerId": "<string>",
"domainId": "<string>"
}
]
}
}{
"error": "unknown_error",
"error_description": "Something went wrong"
}{
"error": "unknown_error",
"error_description": "Something went wrong"
}{
"error": "unknown_error",
"error_description": "Something went wrong"
}Post apiutilitiesv0registryburnv0request
Get the factory and choice context for creating a burn request.
curl --request POST \
--url https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request \
--header 'Content-Type: application/json' \
--data '
{
"holder": "<string>",
"holdingContractIds": [
"<string>"
],
"instrumentId": {
"admin": "<string>",
"id": "<string>"
}
}
'import requests
url = "https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request"
payload = {
"holder": "<string>",
"holdingContractIds": ["<string>"],
"instrumentId": {
"admin": "<string>",
"id": "<string>"
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
holder: '<string>',
holdingContractIds: ['<string>'],
instrumentId: {admin: '<string>', id: '<string>'}
})
};
fetch('https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'holder' => '<string>',
'holdingContractIds' => [
'<string>'
],
'instrumentId' => [
'admin' => '<string>',
'id' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request"
payload := strings.NewReader("{\n \"holder\": \"<string>\",\n \"holdingContractIds\": [\n \"<string>\"\n ],\n \"instrumentId\": {\n \"admin\": \"<string>\",\n \"id\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request")
.header("Content-Type", "application/json")
.body("{\n \"holder\": \"<string>\",\n \"holdingContractIds\": [\n \"<string>\"\n ],\n \"instrumentId\": {\n \"admin\": \"<string>\",\n \"id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.utilities.digitalasset.com/api/utilities/v0/registry/burn/v0/request")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"holder\": \"<string>\",\n \"holdingContractIds\": [\n \"<string>\"\n ],\n \"instrumentId\": {\n \"admin\": \"<string>\",\n \"id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"factoryId": "<string>",
"choiceContext": {
"choiceContextData": {},
"disclosedContracts": [
{
"contractId": "<string>",
"templateId": "<string>",
"createdEventBlob": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"synchronizerId": "<string>",
"domainId": "<string>"
}
]
}
}{
"error": "unknown_error",
"error_description": "Something went wrong"
}{
"error": "unknown_error",
"error_description": "Something went wrong"
}{
"error": "unknown_error",
"error_description": "Something went wrong"
}Body
The request to get the factory and choice context for creating a burn request.
Response
ok
A factory contract together with the choice context required to exercise the choice provided by the factory. Typically used to implement the generic initiation of on-ledger workflows via a Daml interface.
Clients SHOULD avoid reusing the same FactoryWithChoiceContext for exercising multiple choices,
as the choice context MAY be specific to the choice being exercised.
The contract ID of the contract of the factory which can be used to create instruction.
The context required to exercise a choice on a contract via an interface.
Used to retrieve additional reference date that is passed in via disclosed contracts,
which are in turn referred to via their contract ID in the choiceContextData.
Show child attributes
Show child attributes
Was this page helpful?