A Passport is the universal identity primitive in Lucid. Everything in the network — models, compute nodes, tools, datasets, and agents — has a passport.
Passport Types
| Type | Description | Example |
|---|
model | LLM or AI model | GPT-4o, Claude 3.5 Sonnet |
compute | Compute node provider | GPU worker, inference server |
tool | External tool or API | Web search, calculator |
dataset | Training or reference data | Knowledge base, embeddings |
agent | Autonomous agent | Planning agent, research agent |
Lifecycle
Created → Active → Deprecated → Revoked
│
└──→ Synced (on-chain)
Create a Passport
const passport = await lucid.passports.create({
name: "my-gpt4o",
type: "model",
metadata: {
provider: "openai",
maxTokens: 128000,
capabilities: ["chat", "function-calling", "vision"]
},
tags: ["production", "gpt-4o"]
});
List & Filter
// List all model passports
const models = await lucid.passports.list({
type: "model",
tags: ["production"]
});
// Get passport stats
const stats = await lucid.passports.stats();
On-Chain Sync
Passports can be synced to Solana for on-chain verification:
await lucid.passports.sync(passportId);
Passport sync is batched — use GET /v1/passports/pending-sync to check the queue.