TOS Name Service (TNS)

TNS (TOS Name Service)
-----------------------------------------------
1. Name Registration
   alice registers -> [email protected]

2. Address Resolution
   [email protected] -> tos1qxy2kgdyg...

3. Ephemeral Messages (like Signal disappearing messages)
   [email protected] -> [email protected]
   Messages auto-delete after N blocks

# Register a name
tos_wallet register_name name=alice
 
# Registration costs 0.1 TOS

const tx = await tos.sendTransaction({
    type: 'RegisterName',
    payload: { name: 'alice' }
});
 
// After confirmation, [email protected] is registered

// Resolve name to address
const result = await fetch('/resolve_name', {
    method: 'POST',
    body: JSON.stringify({ name: 'bob' })
}).then(r => r.json());
 
// result.address = 'tos1qxy2kgdyg...'

# Resolve a name
tos_wallet resolve_name name=bob
 
# Output: [email protected] -> tos1qxy2kgdyg...

# Transfer using TNS name
tos_wallet transfer [email protected] asset=TOS amount=100
 
# Transfer all balance
tos_wallet transfer_all [email protected] asset=TOS

# Send an ephemeral message
tos_wallet send_message recipient=bob message="Hello, Bob!" ttl=1000
 
# TTL range: 100-86400 blocks (~30 min to 3 days)

# List received messages
tos_wallet list_messages page=0
 
# Read a specific message (auto-decrypts)
tos_wallet read_message message_id=<hash>

pub struct EphemeralMessagePayload {
    /// Sender's TNS name hash
    sender_name_hash: Hash,
    /// Recipient's TNS name hash
    recipient_name_hash: Hash,
    /// Message nonce (for replay protection)
    message_nonce: u64,
    /// TTL in blocks
    ttl_blocks: u32,
    /// Encrypted content
    encrypted_content: Vec<u8>,
    /// Decryption handle for recipient
    receiver_handle: DecryptHandle,
}

use tako_sdk::*;
 
fn verify_name_ownership(user: &Address, expected_name_hash: &Hash) -> bool {
    // Get name hash registered by this address
    let name_hash = get_name_hash_by_account(user);
 
    match name_hash {
        Some(hash) => hash == *expected_name_hash,
        None => false
    }
}

// Name Registry Columns
NameHashToAccount:  {blake3(name)} => PublicKey
AccountHasName:     {PublicKey} => blake3(name)
 
// Ephemeral Messages
EphemeralMessages:  {recipient_hash}{created_topo}{msg_id} => MessageData
MessageExpiry:      {expire_topo}{msg_key} => ()
MessageIdIndex:     {msg_id} => expire_topo

pub struct RegisterNamePayload {
    /// Username (without @tos.network suffix)
    name: String,
}
 
// Serialization: 1 byte length + name bytes
// Max size: 1 + 64 = 65 bytes