phygital-token-mcp 0.1.1

package/dist/lib/graphify.js

@@ -0,0 +1,35 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { pathExists, resolveGraphifyGraphPath, resolveRepoRoot } from "./paths.js";
+const execFileAsync = promisify(execFile);
+export async function runGraphify(mode, args) {
+    const repoRoot = resolveRepoRoot();
+    const graphPath = resolveGraphifyGraphPath();
+    const graphExists = await pathExists(graphPath);
+    if (!graphExists) {
+        throw new Error(`Graphify graph not found at ${graphPath}. Clone the phygital-token repo, run "graphify update .", and set PHYGITAL_TOKEN_REPO_ROOT to the repo root — or use search_docs / read_doc instead.`);
+    }
+    const commandArgs = [mode, ...args];
+    try {
+        const { stdout, stderr } = await execFileAsync("graphify", commandArgs, {
+            cwd: repoRoot,
+            maxBuffer: 10 * 1024 * 1024,
+            env: process.env,
+        });
+        const output = [stdout.trim(), stderr.trim()].filter(Boolean).join("\n");
+        return output || "(no output)";
+    }
+    catch (error) {
+        if (error && typeof error === "object" && "stdout" in error) {
+            const execError = error;
+            const output = [execError.stdout?.trim(), execError.stderr?.trim()]
+                .filter(Boolean)
+                .join("\n");
+            if (output) {
+                return output;
+            }
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=graphify.js.map

package/dist/lib/graphify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphify.js","sourceRoot":"","sources":["../../src/lib/graphify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnF,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAI1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAkB,EAClB,IAAc;IAEd,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,wBAAwB,EAAE,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;IAEhD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,+BAA+B,SAAS,sJAAsJ,CAC/L,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,WAAW,EAAE;YACtE,GAAG,EAAE,QAAQ;YACb,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;YAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,OAAO,MAAM,IAAI,aAAa,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC5D,MAAM,SAAS,GAAG,KAA+D,CAAC;YAClF,MAAM,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;iBAChE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/instructions.d.ts

@@ -0,0 +1,131 @@
+import { type Address } from "@solana/kit";
+import { AssetType, type MetadataFields } from "phygital-token-sdk";
+import type { OnChainCompositionPattern } from "./verification.js";
+export declare function planCreateMint(fields: MetadataFields): {
+    instruction: string;
+    sdk: string;
+    metadata: MetadataFields;
+    requiredSigners: {
+        name: string;
+        role: string;
+    }[];
+    requiredAccounts: {
+        name: string;
+        role: string;
+    }[];
+    notes: string[];
+};
+export declare function planMintToken(input: {
+    assetPublicKey: string;
+    mint: string;
+    assetType: "Lockable" | "Transferable";
+    credentialId?: string;
+}): Promise<{
+    instruction: string;
+    sdk: string;
+    assetType: "Lockable" | "Transferable";
+    derivedAccounts: {
+        assetPda: Address;
+        programAuthority: Address<string>;
+        programAuthorityTokenAccount: Address;
+        mint: string;
+        tokenProgram: Address<"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb">;
+        program: Address<"DdwhetyqgSB56XVcR33ySG5dFmvwbjSc5aSMHRg5Bk6A">;
+    };
+    requiredSigners: {
+        name: string;
+        role: string;
+    }[];
+    requiredInputs: {
+        secp256r1Pubkey: string;
+        credentialId: string;
+        assetType: AssetType;
+    };
+    notes: string[];
+}>;
+export declare function planTransfer(input: {
+    assetPublicKey: string;
+    recipient: string;
+    mint?: string;
+    currentOwner?: string;
+}): Promise<{
+    flow: string[];
+    sdk: {
+        begin: string;
+        authenticate: string;
+        complete: string;
+    };
+    challenge: {
+        formula: string;
+        fetchedAt: string;
+        note: string;
+    };
+    derived: {
+        assetPda: Address;
+        assetPublicKey: string;
+    };
+    transferAccounts: {
+        sender: string;
+        recipient: string;
+        mint: string;
+        senderTokenAccount: string | Address;
+        recipientTokenAccount: string | Address;
+        tokenProgram: Address<"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb">;
+        program: Address<"DdwhetyqgSB56XVcR33ySG5dFmvwbjSc5aSMHRg5Bk6A">;
+    };
+    instructions: string[];
+    notes: string[];
+}>;
+export declare function planVerifyAsset(input: {
+    message: string;
+    assetPublicKey?: string;
+    onChainPattern?: OnChainCompositionPattern;
+}): Promise<{
+    onChainPattern: OnChainCompositionPattern;
+    patternName: string;
+    flow: string[];
+    sdk: {
+        begin: string;
+        authenticate: string;
+        buildArgs: string;
+        complete: string;
+        instruction: string;
+        offChainAuthOnly: string;
+    };
+    message: {
+        utf8: string;
+        byteLength: number;
+        onChainHash: string;
+    };
+    challenge: {
+        formula: string;
+        fetchedAt: string;
+        note: string;
+    };
+    derived: {
+        assetPda: string;
+        assetPublicKey: string | undefined;
+    } | undefined;
+    transactionLayout: {
+        order: string[];
+        verifyAssetAccounts: {
+            asset: string;
+            slot_hashes: string;
+            instructions_sysvar: string;
+        };
+        verifyAssetArgs: {
+            secp256r1VerifyArgs: string;
+            message: string;
+        };
+    };
+    programSide: string;
+    buildVerifyAssetArgsReturns: {
+        asset: string;
+        assetPda: string;
+        secp256r1Verify: string;
+        signedMessageIndex: string;
+        clientDataJson: string;
+    };
+    notes: string[];
+}>;
+export declare function parseAssetType(value: string): "Lockable" | "Transferable";

package/dist/lib/instructions.js

@@ -0,0 +1,232 @@
+import { address, getAddressEncoder, getProgramDerivedAddress, } from "@solana/kit";
+import { AssetType, PHYGITAL_TOKEN_PROGRAM_ADDRESS, findProgramAuthorityPda, parseSecp256r1Pubkey, validateMetadataFields, findAssetPda, } from "phygital-token-sdk";
+import { sha256 } from "@noble/hashes/sha2.js";
+const TOKEN_2022_PROGRAM_ADDRESS = address("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb");
+const ASSOCIATED_TOKEN_PROGRAM_ADDRESS = address("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL");
+async function findAssociatedTokenAddress(owner, mint, tokenProgram) {
+    const [ata] = await getProgramDerivedAddress({
+        programAddress: ASSOCIATED_TOKEN_PROGRAM_ADDRESS,
+        seeds: [
+            getAddressEncoder().encode(owner),
+            getAddressEncoder().encode(tokenProgram),
+            getAddressEncoder().encode(mint),
+        ],
+    });
+    return ata;
+}
+export function planCreateMint(fields) {
+    validateMetadataFields(fields);
+    return {
+        instruction: "create_mint",
+        sdk: "buildCreateMintInstructions",
+        metadata: fields,
+        requiredSigners: [
+            { name: "payer", role: "Pays rent and transaction fees" },
+            { name: "owner", role: "Design mint owner / update authority" },
+            { name: "groupMintAuthority", role: "Authority over the collection group mint" },
+            { name: "mint", role: "New design mint keypair (caller-supplied signer)" },
+        ],
+        requiredAccounts: [
+            { name: "groupMint", role: "Token-2022 collection (group) parent mint" },
+        ],
+        notes: [
+            "Creates a shared design mint (SFT template) within a collection.",
+            "Metadata name ≤ 32, symbol ≤ 10, uri ≤ 200 characters.",
+        ],
+    };
+}
+export async function planMintToken(input) {
+    const secp256r1Pubkey = parseSecp256r1Pubkey(input.assetPublicKey);
+    const assetPda = await findAssetPda(secp256r1Pubkey);
+    const [programAuthority] = await findProgramAuthorityPda();
+    const mint = address(input.mint);
+    const programAuthorityTokenAccount = await findAssociatedTokenAddress(programAuthority, mint, TOKEN_2022_PROGRAM_ADDRESS);
+    const assetType = input.assetType === "Lockable" ? AssetType.Lockable : AssetType.Transferable;
+    return {
+        instruction: "mint_token",
+        sdk: "buildMintTokenInstructions",
+        assetType: input.assetType,
+        derivedAccounts: {
+            assetPda,
+            programAuthority,
+            programAuthorityTokenAccount,
+            mint: input.mint,
+            tokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+            program: PHYGITAL_TOKEN_PROGRAM_ADDRESS,
+        },
+        requiredSigners: [
+            { name: "authority", role: "Mint authority for the design mint" },
+        ],
+        requiredInputs: {
+            secp256r1Pubkey: input.assetPublicKey,
+            credentialId: input.credentialId ?? "(base64url, 64 bytes when decoded)",
+            assetType,
+        },
+        notes: [
+            "Mints one SPL token into program custody and initializes the asset PDA.",
+            "Passkey pubkey must be compressed secp256r1 (33 bytes, 0x02/0x03 prefix).",
+        ],
+    };
+}
+export async function planTransfer(input) {
+    const assetPda = await findAssetPda(parseSecp256r1Pubkey(input.assetPublicKey));
+    const recipient = address(input.recipient);
+    let senderTokenAccount;
+    let recipientTokenAccount;
+    if (input.mint && input.currentOwner) {
+        const mint = address(input.mint);
+        const owner = address(input.currentOwner);
+        senderTokenAccount = await findAssociatedTokenAddress(owner, mint, TOKEN_2022_PROGRAM_ADDRESS);
+        recipientTokenAccount = await findAssociatedTokenAddress(recipient, mint, TOKEN_2022_PROGRAM_ADDRESS);
+    }
+    return {
+        flow: [
+            "1. beginTransfer({ rpc, displayInfo }) — fetch slot hash, build challenge",
+            "2. authenticatePasskeyForTransfer(session) — NFC/WebAuthn tap on physical asset",
+            "3. completeTransfer(session, webAuthnResponse, recipient) — build secp256r1_verify + execute_transfer",
+        ],
+        sdk: {
+            begin: "beginTransfer",
+            authenticate: "authenticatePasskeyForTransfer",
+            complete: "completeTransfer",
+        },
+        challenge: {
+            formula: "SHA256('transfer' || SHA256(assetPda) || slotHash)",
+            fetchedAt: "beginTransfer reads slot_hashes sysvar (~512 slot window)",
+            note: "Run beginTransfer with a live rpc to get challengeBase64 and slotNumber.",
+        },
+        derived: {
+            assetPda,
+            assetPublicKey: input.assetPublicKey,
+        },
+        transferAccounts: {
+            sender: input.currentOwner ?? "(fetch via fetchAssetDisplayInfo or on-chain asset account)",
+            recipient: input.recipient,
+            mint: input.mint ?? "(from asset / display info)",
+            senderTokenAccount: senderTokenAccount ??
+                "(ATA for currentOwner + mint — derive when mint and owner are known)",
+            recipientTokenAccount: recipientTokenAccount ??
+                "(ATA for recipient + mint — derive when mint is known)",
+            tokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+            program: PHYGITAL_TOKEN_PROGRAM_ADDRESS,
+        },
+        instructions: ["secp256r1_verify", "execute_transfer"],
+        notes: [
+            "Recipient is chosen at wallet confirmation — not bound in the passkey signature.",
+            "Challenge is slot-bound; complete the flow promptly (~512 slots).",
+            "Optional mint and currentOwner inputs enable ATA derivation in this plan output.",
+        ],
+    };
+}
+function buildVerifyAssetChallengeDescription(message) {
+    const messageBytes = new TextEncoder().encode(message);
+    const messageHash = sha256(messageBytes);
+    return `SHA256('verify_asset' || SHA256(message[${messageBytes.length} bytes]) || slotHash) — messageHash prefix: ${Buffer.from(messageHash.subarray(0, 8)).toString("hex")}…`;
+}
+export async function planVerifyAsset(input) {
+    const messageBytes = new TextEncoder().encode(input.message);
+    let assetPda;
+    if (input.assetPublicKey) {
+        assetPda = await findAssetPda(parseSecp256r1Pubkey(input.assetPublicKey));
+    }
+    const pattern = input.onChainPattern ?? "inspect";
+    const patternMeta = {
+        inspect: {
+            transactionOrder: ["secp256r1_verify", "verify_asset", "your_program_ix"],
+            clientSteps: [
+                "beginVerifyAsset({ rpc, message })",
+                "authenticatePasskeyForVerifyAsset(session)",
+                "completeVerifyAsset(session, response) — or buildVerifyAssetArgs + getVerifyAssetInstruction",
+                "buildYourProgramInstruction(/* same message bytes */)",
+                "sendTransaction([secp256r1Verify, verifyAssetIx, yourIx])",
+            ],
+            programSide: "Your Rust program scans instructions_sysvar for preceding verify_asset; validates message",
+            clientSdk: ["completeVerifyAsset", "getVerifyAssetInstruction"],
+        },
+        cpi: {
+            transactionOrder: ["secp256r1_verify", "your_program_ix"],
+            clientSteps: [
+                "beginVerifyAsset({ rpc, message })",
+                "authenticatePasskeyForVerifyAsset(session)",
+                "buildVerifyAssetArgs(session, response) — secp256r1Verify + verify args",
+                "buildYourProgramInstruction({ secp256r1VerifyArgs, message, assetPda })",
+                "sendTransaction([secp256r1Verify, yourIx]) — your program CPIs verify_asset",
+            ],
+            programSide: "Your Rust program CPIs verify_asset via VerifyAssetCpiBuilder (phygital-token-client)",
+            clientSdk: ["buildVerifyAssetArgs"],
+        },
+        standalone: {
+            transactionOrder: ["secp256r1_verify", "verify_asset"],
+            clientSteps: [
+                "beginVerifyAsset({ rpc, message })",
+                "authenticatePasskeyForVerifyAsset(session)",
+                "completeVerifyAsset(session, response)",
+                "sendTransaction([secp256r1Verify, verifyAssetIx])",
+            ],
+            programSide: "None — no custom program",
+            clientSdk: ["completeVerifyAsset"],
+        },
+    }[pattern];
+    return {
+        onChainPattern: pattern,
+        patternName: pattern === "inspect"
+            ? "A — client posts verify_asset, program inspects"
+            : pattern === "cpi"
+                ? "B — client posts secp256r1_verify, program CPIs verify_asset"
+                : "Standalone verify_asset",
+        flow: patternMeta.clientSteps,
+        sdk: {
+            begin: "beginVerifyAsset",
+            authenticate: "authenticatePasskeyForVerifyAsset",
+            buildArgs: "buildVerifyAssetArgs",
+            complete: "completeVerifyAsset",
+            instruction: "getVerifyAssetInstruction",
+            offChainAuthOnly: "verifyWithChallengeResponse (does NOT submit verify_asset)",
+        },
+        message: {
+            utf8: input.message,
+            byteLength: messageBytes.length,
+            onChainHash: "SHA256(message) — must match bytes passed to verify_asset",
+        },
+        challenge: {
+            formula: buildVerifyAssetChallengeDescription(input.message),
+            fetchedAt: "beginVerifyAsset reads slot_hashes sysvar (~512 slot window)",
+            note: "Run beginVerifyAsset with a live rpc to get challengeBase64 and slotNumber.",
+        },
+        derived: assetPda ? { assetPda, assetPublicKey: input.assetPublicKey } : undefined,
+        transactionLayout: {
+            order: patternMeta.transactionOrder,
+            verifyAssetAccounts: {
+                asset: "writable PDA matching passkey pubkey",
+                slot_hashes: "SysvarS1otHashes111111111111111111111111111",
+                instructions_sysvar: "Sysvar1nstructions1111111111111111111111111",
+            },
+            verifyAssetArgs: {
+                secp256r1VerifyArgs: "{ signedMessageIndex, slotNumber, clientDataJson }",
+                message: "same Uint8Array as beginVerifyAsset",
+            },
+        },
+        programSide: patternMeta.programSide,
+        buildVerifyAssetArgsReturns: {
+            asset: "decoded on-chain Asset account",
+            assetPda: "Address",
+            secp256r1Verify: "Instruction for Secp256r1SigVerify program",
+            signedMessageIndex: "number",
+            clientDataJson: "Uint8Array",
+        },
+        notes: [
+            "verifyWithChallengeResponse is off-chain only — it does not submit verify_asset.",
+            "Pattern A: client includes verify_asset; your program inspects instructions sysvar.",
+            "Pattern B: client uses buildVerifyAssetArgs; your program CPIs verify_asset.",
+            "verify_asset updates asset.last_transfer_slot; slot must be strictly increasing.",
+        ],
+    };
+}
+export function parseAssetType(value) {
+    const normalized = value.trim();
+    if (normalized === "Lockable" || normalized === "Transferable") {
+        return normalized;
+    }
+    throw new Error('assetType must be "Lockable" or "Transferable".');
+}
+//# sourceMappingURL=instructions.js.map

package/dist/lib/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"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"}

package/dist/lib/paths.d.ts

@@ -0,0 +1,14 @@
+/** MCP package root (`mcp/phygital-token/`). */
+export declare const MCP_PACKAGE_ROOT: string;
+export declare const MCP_DOCS_DIR: string;
+export declare const GLOSSARY_PATH: string;
+/** Monorepo root when developing in-tree; override with PHYGITAL_TOKEN_REPO_ROOT. */
+export declare function resolveRepoRoot(): string;
+/** SDK docs from the installed npm package, or monorepo fallback. */
+export declare function resolveSdkDocsDir(): Promise<string | undefined>;
+export declare function resolveSdkReadmePath(): Promise<string | undefined>;
+export declare function resolveGraphifyGraphPath(): string;
+export declare function resolveVerifyTsPath(): string;
+export declare function resolveVerifyAssetTsPath(): string;
+export declare function resolveRustVerifyAssetPath(): string;
+export declare function pathExists(filePath: string): Promise<boolean>;

package/dist/lib/paths.js

@@ -0,0 +1,77 @@
+import { createRequire } from "node:module";
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const require = createRequire(import.meta.url);
+/** MCP package root (`mcp/phygital-token/`). */
+export const MCP_PACKAGE_ROOT = PACKAGE_ROOT;
+export const MCP_DOCS_DIR = path.join(PACKAGE_ROOT, "docs");
+export const GLOSSARY_PATH = path.join(MCP_DOCS_DIR, "glossary.md");
+/** Monorepo root when developing in-tree; override with PHYGITAL_TOKEN_REPO_ROOT. */
+export function resolveRepoRoot() {
+    const override = process.env.PHYGITAL_TOKEN_REPO_ROOT?.trim();
+    if (override) {
+        return override;
+    }
+    return path.resolve(PACKAGE_ROOT, "../..");
+}
+function resolveSdkPackageRoot() {
+    try {
+        return path.dirname(require.resolve("phygital-token-sdk/package.json"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** SDK docs from the installed npm package, or monorepo fallback. */
+export async function resolveSdkDocsDir() {
+    const sdkRoot = resolveSdkPackageRoot();
+    if (sdkRoot) {
+        const docsDir = path.join(sdkRoot, "docs");
+        if (await pathExists(docsDir)) {
+            return docsDir;
+        }
+    }
+    const monorepoDocs = path.join(resolveRepoRoot(), "clients/js/phygital-token/docs");
+    if (await pathExists(monorepoDocs)) {
+        return monorepoDocs;
+    }
+    return undefined;
+}
+export async function resolveSdkReadmePath() {
+    const sdkRoot = resolveSdkPackageRoot();
+    if (sdkRoot) {
+        const readmePath = path.join(sdkRoot, "README.md");
+        if (await pathExists(readmePath)) {
+            return readmePath;
+        }
+    }
+    const monorepoReadme = path.join(resolveRepoRoot(), "clients/js/phygital-token/README.md");
+    if (await pathExists(monorepoReadme)) {
+        return monorepoReadme;
+    }
+    return undefined;
+}
+export function resolveGraphifyGraphPath() {
+    return path.join(resolveRepoRoot(), "graphify-out/graph.json");
+}
+export function resolveVerifyTsPath() {
+    return path.join(resolveRepoRoot(), "clients/js/phygital-token/src/utils/verify.ts");
+}
+export function resolveVerifyAssetTsPath() {
+    return path.join(resolveRepoRoot(), "clients/js/phygital-token/src/instructions/verifyAsset.ts");
+}
+export function resolveRustVerifyAssetPath() {
+    return path.join(resolveRepoRoot(), "clients/rust/phygital-token/src/generated/instructions/verify_asset.rs");
+}
+export async function pathExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"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"}

package/dist/lib/rpc.d.ts

@@ -0,0 +1,3 @@
+import { type Rpc, type SolanaRpcApi } from "@solana/kit";
+export declare function getRpcUrl(override?: string): string;
+export declare function createRpc(override?: string): Rpc<SolanaRpcApi>;

package/dist/lib/rpc.js

@@ -0,0 +1,22 @@
+import { createSolanaRpc } from "@solana/kit";
+let cachedRpc = null;
+let cachedRpcUrl = null;
+export function getRpcUrl(override) {
+    const url = override?.trim() ||
+        process.env.PHYGITAL_TOKEN_RPC_URL?.trim() ||
+        process.env.HELIUS_RPC_URL?.trim();
+    if (!url) {
+        throw new Error("RPC URL required. Pass rpcUrl to the tool or set PHYGITAL_TOKEN_RPC_URL (or HELIUS_RPC_URL).");
+    }
+    return url;
+}
+export function createRpc(override) {
+    const url = getRpcUrl(override);
+    if (cachedRpc && cachedRpcUrl === url) {
+        return cachedRpc;
+    }
+    cachedRpc = createSolanaRpc(url);
+    cachedRpcUrl = url;
+    return cachedRpc;
+}
+//# sourceMappingURL=rpc.js.map

package/dist/lib/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/lib/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AAE3E,IAAI,SAAS,GAA6B,IAAI,CAAC;AAC/C,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,MAAM,UAAU,SAAS,CAAC,QAAiB;IACzC,MAAM,GAAG,GACP,QAAQ,EAAE,IAAI,EAAE;QAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,EAAE;QAC1C,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAErC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,8FAA8F,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAiB;IACzC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEhC,IAAI,SAAS,IAAI,YAAY,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACjC,YAAY,GAAG,GAAG,CAAC;IACnB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/sdk-surface.d.ts

@@ -0,0 +1,33 @@
+export declare const SDK_SURFACE: {
+    readonly mint: readonly ["buildCreateMintInstructions", "buildMintTokenInstructions", "parseSecp256r1Pubkey", "parseCredentialId", "validateMetadataFields"];
+    readonly transfer: readonly ["beginTransfer", "authenticatePasskeyForTransfer", "completeTransfer"];
+    readonly verifyAssetComposable: readonly ["beginVerifyAsset", "authenticatePasskeyForVerifyAsset", "buildVerifyAssetArgs", "completeVerifyAsset"];
+    readonly verification: readonly ["verifyDynamicUrl", "verifyDynamicUrlWithoutCounterCheck", "verifyWithChallengeResponse", "verifyWithChallengeResponseOverNfc"];
+    readonly onChainComposition: {
+        readonly patternA_inspect: {
+            readonly client: readonly ["beginVerifyAsset", "completeVerifyAsset"];
+            readonly transaction: readonly ["secp256r1_verify", "verify_asset", "your_program_ix"];
+            readonly program: "inspect instructions sysvar for verify_asset message";
+        };
+        readonly patternB_cpi: {
+            readonly client: readonly ["beginVerifyAsset", "buildVerifyAssetArgs"];
+            readonly transaction: readonly ["secp256r1_verify", "your_program_ix"];
+            readonly program: "CPI verify_asset via VerifyAssetCpiBuilder";
+        };
+    };
+    readonly assetLookup: readonly ["findAssetPda", "fetchAssetFromCredentialId", "fetchAllAssetsFromOwner", "fetchAssetDisplayInfo", "resolveMedia"];
+    readonly gating: readonly ["Gating", "GatingTraitValue", "formatGatingPredicate", "summarizeGatingEvaluationFailure", "summarizeGatingFailure", "summarizeGatingTierFailure", "evaluateAssetGating"];
+    readonly gatingTypes: readonly ["EvaluateAssetGatingOptions", "GatingFilter", "GatingAssetPredicate", "GatingTier", "GatingEvaluationResult", "GatingFilterResult", "GatingTierEvaluationResult", "GatingTiersEvaluationResult"];
+    readonly generated: readonly ["getCreateMintInstructionAsync", "getMintTokenInstructionAsync", "getExecuteTransferInstructionAsync", "getVerifyAssetInstruction", "getSetLockStateInstruction", "fetchAsset", "findProgramAuthorityPda", "PHYGITAL_TOKEN_PROGRAM_ADDRESS"];
+    readonly rustClient: {
+        readonly crate: "phygital-token-client";
+        readonly path: "clients/rust/phygital-token";
+        readonly features: readonly ["anchor", "fetch"];
+        readonly cpi: readonly ["VerifyAssetCpi", "VerifyAssetCpiBuilder", "VerifyAssetInstructionArgs"];
+        readonly types: readonly ["Asset", "Secp256r1VerifyArgs", "AssetType"];
+    };
+};
+export declare function readSourceExcerpt(which: "verify.ts" | "verifyAsset.ts" | "rust_verify_asset.rs", maxLines?: number): Promise<{
+    path: string;
+    excerpt: string;
+}>;