curl -X POST https://verification.didit.me/v3/travel-rule/widget-session/ \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"wallet_address":"0xd3b62acb76fb27a7f8961ec40fa11746b113aca9","chain":"ETH","holder_name":"Jane Doe","transaction_id":"99999999-aaaa-bbbb-cccc-dddddddddddd"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.travel_rule.create_widget_session(
wallet_address="0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
chain="ETH",
holder_name="Jane Doe",
vendor_data="user-042",
transaction_id="99999999-aaaa-bbbb-cccc-dddddddddddd",
expires_in_minutes=60,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.travelRule.createWidgetSession({
wallet_address: "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
chain: "ETH",
holder_name: "Jane Doe",
vendor_data: "user-042",
transaction_id: "99999999-aaaa-bbbb-cccc-dddddddddddd",
expires_in_minutes: 60,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.TravelRule.CreateWidgetSession(ctx, didit.TravelRuleCreateWidgetSessionParams{
Body: didit.TravelRuleWidgetSessionCreate{
WalletAddress: didit.String("0xd3b62acb76fb27a7f8961ec40fa11746b113aca9"),
Chain: didit.String("ETH"),
HolderName: didit.String("Jane Doe"),
VendorData: didit.String("user-042"),
TransactionID: didit.String("99999999-aaaa-bbbb-cccc-dddddddddddd"),
ExpiresInMinutes: didit.Int(60),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.TravelRuleWidgetSessionCreate;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.travelRule().createWidgetSession(TravelRuleWidgetSessionCreate.builder()
.walletAddress("0xd3b62acb76fb27a7f8961ec40fa11746b113aca9")
.chain("ETH")
.holderName("Jane Doe")
.vendorData("user-042")
.transactionId("99999999-aaaa-bbbb-cccc-dddddddddddd")
.expiresInMinutes(60L)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->travelRule->createWidgetSession([
'wallet_address' => '0xd3b62acb76fb27a7f8961ec40fa11746b113aca9',
'chain' => 'ETH',
'holder_name' => 'Jane Doe',
'vendor_data' => 'user-042',
'transaction_id' => '99999999-aaaa-bbbb-cccc-dddddddddddd',
'expires_in_minutes' => 60,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.travel_rule.create_widget_session(
wallet_address: "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
chain: "ETH",
holder_name: "Jane Doe",
vendor_data: "user-042",
transaction_id: "99999999-aaaa-bbbb-cccc-dddddddddddd",
expires_in_minutes: 60
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.TravelRule.CreateWidgetSessionAsync(new TravelRuleWidgetSessionCreate
{
WalletAddress = "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
Chain = "ETH",
HolderName = "Jane Doe",
VendorData = "user-042",
TransactionId = "99999999-aaaa-bbbb-cccc-dddddddddddd",
ExpiresInMinutes = 60,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"widget_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"token": "<string>",
"url": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}{
"widget_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"token": "<string>",
"url": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}{
"callback_url": [
"callback_url must be an absolute http(s) URL."
]
}Mint Wallet-Ownership Widget API: Proof of Control
Create a wallet-ownership widget session: customers prove control of a crypto wallet by message signing, Satoshi test, screenshot or self-declaration
curl -X POST https://verification.didit.me/v3/travel-rule/widget-session/ \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"wallet_address":"0xd3b62acb76fb27a7f8961ec40fa11746b113aca9","chain":"ETH","holder_name":"Jane Doe","transaction_id":"99999999-aaaa-bbbb-cccc-dddddddddddd"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.travel_rule.create_widget_session(
wallet_address="0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
chain="ETH",
holder_name="Jane Doe",
vendor_data="user-042",
transaction_id="99999999-aaaa-bbbb-cccc-dddddddddddd",
expires_in_minutes=60,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.travelRule.createWidgetSession({
wallet_address: "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
chain: "ETH",
holder_name: "Jane Doe",
vendor_data: "user-042",
transaction_id: "99999999-aaaa-bbbb-cccc-dddddddddddd",
expires_in_minutes: 60,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.TravelRule.CreateWidgetSession(ctx, didit.TravelRuleCreateWidgetSessionParams{
Body: didit.TravelRuleWidgetSessionCreate{
WalletAddress: didit.String("0xd3b62acb76fb27a7f8961ec40fa11746b113aca9"),
Chain: didit.String("ETH"),
HolderName: didit.String("Jane Doe"),
VendorData: didit.String("user-042"),
TransactionID: didit.String("99999999-aaaa-bbbb-cccc-dddddddddddd"),
ExpiresInMinutes: didit.Int(60),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.TravelRuleWidgetSessionCreate;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.travelRule().createWidgetSession(TravelRuleWidgetSessionCreate.builder()
.walletAddress("0xd3b62acb76fb27a7f8961ec40fa11746b113aca9")
.chain("ETH")
.holderName("Jane Doe")
.vendorData("user-042")
.transactionId("99999999-aaaa-bbbb-cccc-dddddddddddd")
.expiresInMinutes(60L)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->travelRule->createWidgetSession([
'wallet_address' => '0xd3b62acb76fb27a7f8961ec40fa11746b113aca9',
'chain' => 'ETH',
'holder_name' => 'Jane Doe',
'vendor_data' => 'user-042',
'transaction_id' => '99999999-aaaa-bbbb-cccc-dddddddddddd',
'expires_in_minutes' => 60,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.travel_rule.create_widget_session(
wallet_address: "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
chain: "ETH",
holder_name: "Jane Doe",
vendor_data: "user-042",
transaction_id: "99999999-aaaa-bbbb-cccc-dddddddddddd",
expires_in_minutes: 60
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.TravelRule.CreateWidgetSessionAsync(new TravelRuleWidgetSessionCreate
{
WalletAddress = "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
Chain = "ETH",
HolderName = "Jane Doe",
VendorData = "user-042",
TransactionId = "99999999-aaaa-bbbb-cccc-dddddddddddd",
ExpiresInMinutes = 60,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"widget_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"token": "<string>",
"url": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}{
"widget_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"token": "<string>",
"url": "<string>",
"expires_at": "2023-11-07T05:31:56Z"
}{
"callback_url": [
"callback_url must be an absolute http(s) URL."
]
}Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Headers
Optional retry-safety key you choose for one operation, up to 255 characters (a UUID works). A request repeated with the same key, endpoint, query and body is answered with the first response, same status and same body, and runs and bills nothing a second time. The same key with another endpoint, query or body returns 409 idempotency_key_reused, and while the first request is still running, 409 idempotency_key_in_progress with Retry-After. A failed request (any 4xx or 5xx) is not stored, so you can send it again with the same key. Keys belong to your application, whether you call with an API key or an access token. See Retries and idempotency.
1 - 255Body
Chain token for the address, for example ETH, BTC or SOL. Use the same token as in your wallet address book. Message signing and the Satoshi test are offered only for a supported chain. The address book entry the proof verifies stores it under its canonical identifier (ETH, BTC, SOL, TRX).
32Optional. Request the ownership proof of this address book entry instead of passing wallet_address and chain. The entry must be a customer wallet with a holder (holder_vendor_data), an address and a chain; the saved wallet and holder are always used and a conflicting wallet_address, chain, holder_name or vendor_data is rejected. Cannot be combined with transaction_id.
Response
An existing active proof link for the wallet address book entry, returned again (wallet_entry_id requests only).