For the complete documentation index, see llms.txt. This page is also available as Markdown.

Call Verification Flow

Each phone number can be registered as an NFT, enabling secure verification of calls by mapping identities to digital keys on the Sui blockchain.

How It Works

🧾 KNS NFT Registration

  • End users register their phone numbers (e.g., +17025551234), which are minted as KNS NFTs and stored in their wallet.

  • These NFTs can be branded and optionally display phone number metadata.


πŸ” Signing Key Registration (For Telecom Operators)

  • Telecom operators can generate and register signing keys.

  • The keys and associated certificate repository are managed by the operator from their own wallet.

  • This process is handled on the Sui blockchain.

  • Operators can automate this via CLI or integrate it into their own systems using: register-keystore.ts


πŸ”„ KNS to Registry Mapping

  • Karrier One provides a secure, authenticated API to map phone numbers to their KNS NFT IDs or certificate registry IDs.

  • Phone numbers are not stored on-chain (ensuring privacy).

  • Off-chain logic (e.g., vendor defaults) is supported.

  • Mapping data can be exported to S3/CDN-like systems for high performance.

API Endpoint: https://kns-api.karrier.dev


πŸ—‚οΈ Certificate Registry Linking

  • A global shared object maps a KNS NFT to one or more certificate repositories.

  • KNS holders have full control over who is authorized to sign on their behalf:

    • Telcos

    • PBX systems

    • Dialers


πŸ› οΈ Operational Workflow

πŸ“Œ Key Registration & Certificate Setup

  1. Generate ES256 key pair

  2. Register keys on-chain

  3. Assign to repositories

  4. Upload public keys (S3/IPFS/etc.)

  5. Done

πŸ“ž Signing & Authenticating a Call

  1. Sign a Call

    • Generate JWT (STIR/SHAKEN)-like identity header

    • Sign with private key

  2. Authenticate Call

    • Lookup repository

    • Verify signature using public key

πŸ” Repository Lookup

  1. Decode JWT

  2. Map phone number to KNS ID

  3. Resolve KNS ID to registry

  4. Retrieve public key

  5. Verify signature


Conclusion

The Call Verification Flow by Karrier One ensures cryptographic authenticity of telecom calls using NFTs, public key infrastructure, and blockchain registries. It provides an interoperable, privacy-focused, and fully decentralized approach to secure communication.

For help or integration support, reach out to support@karrier.one.

Flow Chart & Overview

Flow Chart of Call Verification Flow

Last updated