Skip to main content

qualia_client_core/wallet/
semantic_tokens.rs

1use serde::{Deserialize, Serialize};
2
3#[derive(Debug, Clone, Serialize, Deserialize)]
4pub struct SemanticTokenMetadata {
5    pub token_ticker: String,
6    pub token_name: String,
7    pub token_document_url: String,
8    pub token_document_hash: String,
9    pub decimals: u8,
10}
11
12/// Generates an SLP OP_RETURN.
13pub fn generate_slp_op_return(metadata: &SemanticTokenMetadata) -> Vec<u8> {
14    let mut payload = Vec::new();
15
16    payload.push(0x6a); // OP_RETURN
17    payload.extend_from_slice(b"\x04SLP\x00"); // LOKAD ID
18    payload.extend_from_slice(b"\x01\x01"); // Token Type
19    payload.extend_from_slice(b"\x07GENESIS");
20
21    let ticker_bytes = metadata.token_ticker.as_bytes();
22    payload.push(ticker_bytes.len() as u8);
23    payload.extend_from_slice(ticker_bytes);
24
25    let name_bytes = metadata.token_name.as_bytes();
26    payload.push(name_bytes.len() as u8);
27    payload.extend_from_slice(name_bytes);
28
29    let url_bytes = metadata.token_document_url.as_bytes();
30    payload.push(url_bytes.len() as u8);
31    payload.extend_from_slice(url_bytes);
32
33    let hash_bytes = hex::decode(&metadata.token_document_hash).unwrap_or_else(|_| vec![0; 32]);
34    payload.push(hash_bytes.len() as u8);
35    payload.extend_from_slice(&hash_bytes);
36
37    payload.extend_from_slice(&[0x01, metadata.decimals]);
38
39    payload
40}
41
42/// Generates an SLP send OP_RETURN.
43pub fn generate_slp_send_op_return(token_id: &str, amounts: &[u64]) -> Vec<u8> {
44    let mut payload = Vec::new();
45    payload.push(0x6a); // OP_RETURN
46    payload.extend_from_slice(b"\x04SLP\x00"); // LOKAD ID
47    payload.extend_from_slice(b"\x01\x01"); // Token Type
48    payload.extend_from_slice(b"\x04SEND");
49
50    let token_id_bytes = hex::decode(token_id).unwrap_or_else(|_| vec![0; 32]);
51    payload.push(token_id_bytes.len() as u8);
52    payload.extend_from_slice(&token_id_bytes);
53
54    for &amount in amounts {
55        payload.push(0x08);
56        payload.extend_from_slice(&amount.to_be_bytes());
57    }
58
59    payload
60}
61
62/// Generates an ALP send OP_RETURN.
63pub fn generate_alp_send_op_return(token_id: &str, amounts: &[u64]) -> Vec<u8> {
64    let mut payload = Vec::new();
65    payload.push(0x6a); // OP_RETURN
66    payload.extend_from_slice(b"\x04ALP\x00"); // LOKAD ID
67    payload.extend_from_slice(b"\x01\x01"); // Token Type
68    payload.extend_from_slice(b"\x04SEND");
69
70    let token_id_bytes = hex::decode(token_id).unwrap_or_else(|_| vec![0; 32]);
71    payload.push(token_id_bytes.len() as u8);
72    payload.extend_from_slice(&token_id_bytes);
73
74    for &amount in amounts {
75        payload.push(0x08);
76        payload.extend_from_slice(&amount.to_be_bytes());
77    }
78
79    payload
80}
81
82/// Generates semantic-metadata CBOR.
83pub fn generate_semantic_metadata_cbor(
84    subject_did: &str,
85    properties: serde_json::Value,
86) -> Result<Vec<u8>, String> {
87    let doc = serde_json::json!({
88        "@context": "https://qualia.io/contexts/semantic-tokens-v1.jsonld",
89        "@id": subject_did,
90        "@type": "SemanticToken",
91        "properties": properties
92    });
93
94    let mut buffer = Vec::new();
95    ciborium::into_writer(&doc, &mut buffer).map_err(|e| e.to_string())?;
96    Ok(buffer)
97}