@gl-36/sdk 0.0.0-stage → 0.1.0

package/dist/logs.d.ts

@@ -0,0 +1,32 @@
+import type { Address } from "@solana/kit";
+export type Gl36Event = {
+    type: "init";
+    maxSupply: number;
+} | {
+    type: "mint";
+    firstId: number;
+    count: number;
+} | {
+    type: "transfer";
+    id: number;
+} | {
+    type: "list";
+    id: number;
+    price: number;
+} | {
+    type: "buy";
+    id: number;
+    price: number;
+} | {
+    type: "close";
+    minted: number;
+} | {
+    type: "settle";
+} | {
+    type: "rearm";
+} | {
+    type: "withdraw";
+    lamports: bigint;
+};
+export declare function parseLogs(logs: readonly string[], programId: Address): Gl36Event[];
+//# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AA+C3C,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,EAAE,CAkBlF"}

package/dist/logs.js

@@ -0,0 +1,63 @@
+const INVOKE = /^Program (\w+) invoke \[\d+\]$/;
+const EXIT = /^Program (\w+) (success|failed)/;
+const LOG = "Program log: ";
+const ints = (parts, n) => parts.length === n && parts.every((p) => /^\d+$/.test(p)) ? parts.map(Number) : null;
+function parseEvent(message) {
+    const [kind, ...rest] = message.trim().split(/\s+/);
+    switch (kind) {
+        case "init": {
+            const v = ints(rest, 1);
+            return v && { type: "init", maxSupply: v[0] };
+        }
+        case "mint": {
+            const v = ints(rest, 2);
+            return v && { type: "mint", firstId: v[0], count: v[1] };
+        }
+        case "xfer": {
+            const v = ints(rest, 1);
+            return v && { type: "transfer", id: v[0] };
+        }
+        case "list": {
+            const v = ints(rest, 2);
+            return v && { type: "list", id: v[0], price: v[1] };
+        }
+        case "buy": {
+            const v = ints(rest, 2);
+            return v && { type: "buy", id: v[0], price: v[1] };
+        }
+        case "close": {
+            const v = ints(rest, 1);
+            return v && { type: "close", minted: v[0] };
+        }
+        case "settle":
+            return rest.length === 0 ? { type: "settle" } : null;
+        case "rearm":
+            return rest.length === 0 ? { type: "rearm" } : null;
+        case "withdraw":
+            return rest.length === 1 && /^\d+$/.test(rest[0]) ? { type: "withdraw", lamports: BigInt(rest[0]) } : null;
+        default:
+            return null;
+    }
+}
+export function parseLogs(logs, programId) {
+    const stack = [];
+    const events = [];
+    for (const line of logs) {
+        const invoke = INVOKE.exec(line);
+        if (invoke) {
+            stack.push(invoke[1]);
+            continue;
+        }
+        if (EXIT.test(line)) {
+            stack.pop();
+            continue;
+        }
+        if (stack.at(-1) !== programId || !line.startsWith(LOG))
+            continue;
+        const event = parseEvent(line.slice(LOG.length));
+        if (event)
+            events.push(event);
+    }
+    return events;
+}
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

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

package/dist/pda.d.ts

@@ -0,0 +1,3 @@
+import { type Address } from "@solana/kit";
+export declare function findCollection(programId: Address, creator: Address, nonce: number): Promise<[Address, number]>;
+//# sourceMappingURL=pda.d.ts.map

package/dist/pda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../src/pda.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAExF,wBAAsB,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAWpH"}

package/dist/pda.js

@@ -0,0 +1,14 @@
+import { getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
+export async function findCollection(programId, creator, nonce) {
+    if (!Number.isInteger(nonce) || nonce < 0 || nonce > 0xffff_ffff) {
+        throw new RangeError(`nonce must be a u32, got ${nonce}`);
+    }
+    const n = new Uint8Array(4);
+    new DataView(n.buffer).setUint32(0, nonce, true);
+    const [pda, bump] = await getProgramDerivedAddress({
+        programAddress: programId,
+        seeds: [new TextEncoder().encode("col"), getAddressEncoder().encode(creator), n],
+    });
+    return [pda, bump];
+}
+//# sourceMappingURL=pda.js.map

package/dist/pda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.js","sourceRoot":"","sources":["../src/pda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAgB,MAAM,aAAa,CAAC;AAExF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAkB,EAAE,OAAgB,EAAE,KAAa;IACtF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;QACjE,MAAM,IAAI,UAAU,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,wBAAwB,CAAC;QACjD,cAAc,EAAE,SAAS;QACzB,KAAK,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;KACjF,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/dist/price.d.ts

@@ -0,0 +1,5 @@
+export declare function priceToLamports(price: number): bigint;
+export declare function lamportsToPrice(lamports: bigint): number;
+export declare function solToPrice(sol: string | number): number;
+export declare function priceToSol(price: number): string;
+//# sourceMappingURL=price.d.ts.map

package/dist/price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.d.ts","sourceRoot":"","sources":["../src/price.ts"],"names":[],"mappings":"AAUA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CASvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/price.js

@@ -0,0 +1,38 @@
+import { MAX_PRICE, PRICE_UNIT } from "./constants.js";
+const DECIMALS = 6;
+function check(price) {
+    if (!Number.isInteger(price) || price < 0 || price > MAX_PRICE) {
+        throw new RangeError(`price must be an integer from 0 to ${MAX_PRICE} units of 1,000 lamports, got ${price}`);
+    }
+}
+export function priceToLamports(price) {
+    check(price);
+    return BigInt(price) * PRICE_UNIT;
+}
+export function lamportsToPrice(lamports) {
+    if (lamports % PRICE_UNIT !== 0n)
+        throw new RangeError(`${lamports} lamports is not a whole number of price units`);
+    const price = lamports / PRICE_UNIT;
+    if (price < 0n || price > BigInt(MAX_PRICE))
+        throw new RangeError(`${lamports} lamports is outside the u32 price range`);
+    return Number(price);
+}
+export function solToPrice(sol) {
+    const text = typeof sol === "number" ? sol.toFixed(DECIMALS) : sol.trim();
+    const m = /^(\d*)(?:[.,](\d*))?$/.exec(text);
+    if (!m || (m[1] === "" && !m[2]))
+        throw new RangeError(`not a SOL amount: ${sol}`);
+    const frac = (m[2] ?? "").replace(/0+$/, "");
+    if (frac.length > DECIMALS)
+        throw new RangeError(`prices go down to 0.000001 SOL, got ${sol}`);
+    const price = Number(BigInt(m[1] || "0") * 10n ** BigInt(DECIMALS) + BigInt(frac.padEnd(DECIMALS, "0") || "0"));
+    check(price);
+    return price;
+}
+export function priceToSol(price) {
+    check(price);
+    const whole = Math.floor(price / 10 ** DECIMALS);
+    const frac = String(price % 10 ** DECIMALS).padStart(DECIMALS, "0").replace(/0+$/, "");
+    return frac ? `${whole}.${frac}` : String(whole);
+}
+//# sourceMappingURL=price.js.map

package/dist/price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../src/price.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,QAAQ,GAAG,CAAC,CAAC;AAEnB,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QAC/D,MAAM,IAAI,UAAU,CAAC,sCAAsC,SAAS,iCAAiC,KAAK,EAAE,CAAC,CAAC;IAChH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,KAAK,CAAC,KAAK,CAAC,CAAC;IACb,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,QAAQ,GAAG,UAAU,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,QAAQ,gDAAgD,CAAC,CAAC;IACpH,MAAM,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;IACpC,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,QAAQ,0CAA0C,CAAC,CAAC;IACzH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAoB;IAC7C,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1E,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAChH,KAAK,CAAC,KAAK,CAAC,CAAC;IACb,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,KAAK,CAAC,KAAK,CAAC,CAAC;IACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,IAAI,QAAQ,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,EAAE,IAAI,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC"}

package/dist/rpc.d.ts

@@ -0,0 +1,26 @@
+import { type Address, type Commitment, type GetAccountInfoApi, type GetMinimumBalanceForRentExemptionApi, type GetProgramAccountsApi, type Rpc } from "@solana/kit";
+import { type Collection, type CollectionHeader, type Slot } from "./account.ts";
+export interface FetchConfig {
+    commitment?: Commitment;
+    programId?: Address;
+}
+export interface FetchedCollection {
+    address: Address;
+    lamports: bigint;
+    data: Uint8Array;
+    collection: Collection;
+}
+export declare function fetchCollection(rpc: Rpc<GetAccountInfoApi>, address: Address, config?: FetchConfig): Promise<FetchedCollection | null>;
+export declare function fetchHeader(rpc: Rpc<GetAccountInfoApi>, address: Address, config?: FetchConfig): Promise<CollectionHeader | null>;
+export declare function fetchSlot(rpc: Rpc<GetAccountInfoApi>, address: Address, id: number, config?: FetchConfig): Promise<Slot | null>;
+export interface FoundCollection {
+    address: Address;
+    header: CollectionHeader;
+}
+export declare function findCollections(rpc: Rpc<GetProgramAccountsApi>, programId: Address, options?: {
+    creator?: Address;
+    commitment?: Commitment;
+}): Promise<FoundCollection[]>;
+export declare function getLamportsPerByte(rpc: Rpc<GetMinimumBalanceForRentExemptionApi>): Promise<bigint>;
+export declare const rentExemptMinimum: (dataLength: number, lamportsPerByte: bigint) => bigint;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EAEZ,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,oCAAoC,EACzC,KAAK,qBAAqB,EAC1B,KAAK,GAAG,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,IAAI,EACV,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;CACxB;AAUD,wBAAsB,eAAe,CACnC,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAQnC;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAWlC;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAC3B,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAYtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,GAAG,CAAC,qBAAqB,CAAC,EAC/B,SAAS,EAAE,OAAO,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAO,GAC3D,OAAO,CAAC,eAAe,EAAE,CAAC,CAiB5B;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,oCAAoC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxG;AAED,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,EAAE,iBAAiB,MAAM,KAAG,MACvB,CAAC"}

package/dist/rpc.js

@@ -0,0 +1,70 @@
+import { getBase58Decoder, getBase64Encoder, } from "@solana/kit";
+import { decodeCollection, decodeHeader, decodeSlot, slotOffset, } from "./account.js";
+import { ACCOUNT_OVERHEAD, COLLECTION_TAG, HEADER_LEN, HEADER_OFFSET, LAYOUT_VERSION, SLOT_LEN } from "./constants.js";
+const bytes = (base64) => new Uint8Array(getBase64Encoder().encode(base64));
+function owned(owner, programId, address) {
+    if (programId !== undefined && owner !== programId) {
+        throw new Error(`${address} is owned by ${owner}, not by the GL-36 program ${programId}`);
+    }
+}
+export async function fetchCollection(rpc, address, config = {}) {
+    const { value } = await rpc
+        .getAccountInfo(address, { encoding: "base64", commitment: config.commitment ?? "confirmed" })
+        .send();
+    if (!value)
+        return null;
+    owned(value.owner, config.programId, address);
+    const data = bytes(value.data[0]);
+    return { address, lamports: BigInt(value.lamports), data, collection: decodeCollection(data) };
+}
+export async function fetchHeader(rpc, address, config = {}) {
+    const { value } = await rpc
+        .getAccountInfo(address, {
+        encoding: "base64",
+        commitment: config.commitment ?? "confirmed",
+        dataSlice: { offset: 0, length: HEADER_LEN },
+    })
+        .send();
+    if (!value)
+        return null;
+    owned(value.owner, config.programId, address);
+    return decodeHeader(bytes(value.data[0]));
+}
+export async function fetchSlot(rpc, address, id, config = {}) {
+    const { value } = await rpc
+        .getAccountInfo(address, {
+        encoding: "base64",
+        commitment: config.commitment ?? "confirmed",
+        dataSlice: { offset: slotOffset(id), length: SLOT_LEN },
+    })
+        .send();
+    if (!value)
+        return null;
+    owned(value.owner, config.programId, address);
+    const data = bytes(value.data[0]);
+    return data.length < SLOT_LEN ? null : decodeSlot(data, id);
+}
+export async function findCollections(rpc, programId, options = {}) {
+    const tagAndVersion = getBase58Decoder().decode(new Uint8Array([COLLECTION_TAG, LAYOUT_VERSION]));
+    const filters = [
+        { memcmp: { offset: 0n, bytes: tagAndVersion, encoding: "base58" } },
+        ...(options.creator
+            ? [{ memcmp: { offset: BigInt(HEADER_OFFSET.creator), bytes: options.creator, encoding: "base58" } }]
+            : []),
+    ];
+    const accounts = (await rpc
+        .getProgramAccounts(programId, {
+        encoding: "base64",
+        commitment: options.commitment ?? "confirmed",
+        dataSlice: { offset: 0, length: HEADER_LEN },
+        filters,
+    })
+        .send());
+    return accounts.map(({ pubkey, account }) => ({ address: pubkey, header: decodeHeader(bytes(account.data[0])) }));
+}
+export async function getLamportsPerByte(rpc) {
+    const min = await rpc.getMinimumBalanceForRentExemption(0n).send();
+    return BigInt(min) / BigInt(ACCOUNT_OVERHEAD);
+}
+export const rentExemptMinimum = (dataLength, lamportsPerByte) => BigInt(ACCOUNT_OVERHEAD + dataLength) * lamportsPerByte;
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/seed.d.ts

@@ -0,0 +1,9 @@
+import { type Address } from "@solana/kit";
+export interface TokenSeedArgs {
+    domain: string;
+    collection: Address;
+    entropy: Uint8Array;
+    id: number;
+}
+export declare function tokenSeed({ domain, collection, entropy, id }: TokenSeedArgs): Promise<Uint8Array>;
+//# sourceMappingURL=seed.d.ts.map

package/dist/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAa9D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CASjG"}

package/dist/seed.js

@@ -0,0 +1,18 @@
+import { getAddressEncoder } from "@solana/kit";
+import { MAX_SUPPLY } from "./constants.js";
+async function sha256(...parts) {
+    const buf = new Uint8Array(new ArrayBuffer(parts.reduce((n, p) => n + p.length, 0)));
+    let off = 0;
+    for (const p of parts) {
+        buf.set(p, off);
+        off += p.length;
+    }
+    return new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", buf));
+}
+export function tokenSeed({ domain, collection, entropy, id }) {
+    if (!Number.isInteger(id) || id < 0 || id >= MAX_SUPPLY)
+        throw new RangeError(`id must be a u16 below ${MAX_SUPPLY}, got ${id}`);
+    const idLe = new Uint8Array([id & 0xff, id >> 8]);
+    return sha256(new TextEncoder().encode(domain), new Uint8Array(getAddressEncoder().encode(collection)), entropy, idLe);
+}
+//# sourceMappingURL=seed.js.map

package/dist/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,KAAK,UAAU,MAAM,CAAC,GAAG,KAAmB;IAC1C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChB,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;AAC/E,CAAC;AASD,MAAM,UAAU,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAiB;IAC1E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,UAAU;QAAE,MAAM,IAAI,UAAU,CAAC,0BAA0B,UAAU,SAAS,EAAE,EAAE,CAAC,CAAC;IACjI,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,MAAM,CACX,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAChC,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EACtD,OAAO,EACP,IAAI,CACL,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@gl-36/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "TypeScript SDK for GL-36, an NFT standard for Solana where a token takes 36 bytes.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "node --test test/*.test.ts",
+    "prepack": "npm run typecheck && npm test && npm run build"
+  },
+  "peerDependencies": {
+    "@solana/kit": "^8.5.0"
+  },
+  "devDependencies": {
+    "@solana/kit": "8.5.0",
+    "@types/node": "24.19.2",
+    "litesvm": "1.6.1",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "homepage": "https://gl36.org/docs/client/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/genloss-36/gl-36.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": "https://github.com/genloss-36/gl-36/issues",
+  "keywords": [
+    "solana",
+    "nft",
+    "gl-36",
+    "kit",
+    "sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/account.ts

@@ -0,0 +1,109 @@
+import { getAddressDecoder, type Address } from "@solana/kit";
+import {
+  COLLECTION_TAG,
+  FLAG_CLOSED,
+  FLAG_SETTLED,
+  HEADER_LEN,
+  HEADER_OFFSET as O,
+  LAYOUT_VERSION,
+  SETTLE_DELAY,
+  SLOT_LEN,
+  SLOT_OFFSET,
+} from "./constants.ts";
+
+export interface Slot {
+  id: number;
+  owner: Address;
+  price: number;
+}
+
+export interface CollectionHeader {
+  bump: number;
+  flags: number;
+  maxSupply: number;
+  minted: number;
+  feeBps: number;
+  nonce: number;
+  mintPrice: bigint;
+  creator: Address;
+  treasury: Address;
+  closeSlot: bigint;
+  entropy: Uint8Array;
+  generatorHash: Uint8Array;
+}
+
+export interface Collection extends CollectionHeader {
+  slots: Slot[];
+}
+
+export type CollectionState = "open" | "closed" | "settled";
+
+export const accountLength = (minted: number) => HEADER_LEN + minted * SLOT_LEN;
+
+export const slotOffset = (id: number) => HEADER_LEN + id * SLOT_LEN;
+
+const view = (data: Uint8Array) => new DataView(data.buffer, data.byteOffset, data.byteLength);
+
+const key = (data: Uint8Array, off: number) => getAddressDecoder().decode(data.subarray(off, off + 32));
+
+export function isCollectionAccount(data: Uint8Array): boolean {
+  if (data.length < HEADER_LEN || data[O.tag] !== COLLECTION_TAG || data[O.version] !== LAYOUT_VERSION) return false;
+  return data.length === accountLength(view(data).getUint16(O.minted, true));
+}
+
+export function decodeHeader(data: Uint8Array): CollectionHeader {
+  if (data.length < HEADER_LEN || data[O.tag] !== COLLECTION_TAG || data[O.version] !== LAYOUT_VERSION) {
+    throw new Error("not a GL-36 collection account");
+  }
+  const v = view(data);
+  return {
+    bump: data[O.bump],
+    flags: data[O.flags],
+    maxSupply: v.getUint16(O.maxSupply, true),
+    minted: v.getUint16(O.minted, true),
+    feeBps: v.getUint16(O.feeBps, true),
+    nonce: v.getUint32(O.nonce, true),
+    mintPrice: v.getBigUint64(O.mintPrice, true),
+    creator: key(data, O.creator),
+    treasury: key(data, O.treasury),
+    closeSlot: v.getBigUint64(O.closeSlot, true),
+    entropy: data.slice(O.entropy, O.entropy + 32),
+    generatorHash: data.slice(O.generatorHash, O.generatorHash + 32),
+  };
+}
+
+export function decodeSlot(bytes: Uint8Array, id: number): Slot {
+  if (bytes.length < SLOT_LEN) throw new Error(`a slot is ${SLOT_LEN} bytes, got ${bytes.length}`);
+  return {
+    id,
+    owner: key(bytes, SLOT_OFFSET.owner),
+    price: view(bytes).getUint32(SLOT_OFFSET.price, true),
+  };
+}
+
+export function decodeCollection(data: Uint8Array): Collection {
+  const header = decodeHeader(data);
+  if (data.length < accountLength(header.minted)) {
+    throw new Error(`account holds ${data.length} bytes, ${accountLength(header.minted)} needed for ${header.minted} slots`);
+  }
+  const slots: Slot[] = [];
+  for (let id = 0; id < header.minted; id++) {
+    const o = slotOffset(id);
+    slots.push(decodeSlot(data.subarray(o, o + SLOT_LEN), id));
+  }
+  return { ...header, slots };
+}
+
+export function collectionState(c: Pick<CollectionHeader, "flags">): CollectionState {
+  if (c.flags & FLAG_SETTLED) return "settled";
+  if (c.flags & FLAG_CLOSED) return "closed";
+  return "open";
+}
+
+export const entropySlot = (c: Pick<CollectionHeader, "closeSlot">): bigint => c.closeSlot + SETTLE_DELAY;
+
+export const listedSlots = (c: Pick<Collection, "slots">): Slot[] =>
+  c.slots.filter((s) => s.price > 0).sort((a, b) => a.price - b.price || a.id - b.id);
+
+export const slotsOwnedBy = (c: Pick<Collection, "slots">, owner: Address): Slot[] =>
+  c.slots.filter((s) => s.owner === owner);

package/src/constants.ts

@@ -0,0 +1,50 @@
+import type { Address } from "@solana/kit";
+
+export const PROGRAM_ID = {
+  mainnet: "GtUakBxu2UXwv68PkLYmkzyAUtLXwqhtbi7W8GUmPmTb" as Address,
+} as const;
+
+export type Cluster = keyof typeof PROGRAM_ID;
+
+export const SYSTEM_PROGRAM = "11111111111111111111111111111111" as Address;
+export const SLOT_HASHES = "SysvarS1otHashes111111111111111111111111111" as Address;
+
+export const COLLECTION_TAG = 1;
+export const LAYOUT_VERSION = 1;
+
+export const HEADER_LEN = 224;
+export const SLOT_LEN = 36;
+export const ACCOUNT_OVERHEAD = 128;
+
+export const PRICE_UNIT = 1_000n;
+export const MAX_PRICE = 0xffff_ffff;
+export const MAX_SUPPLY = 0xffff;
+export const MAX_MINT_BATCH = 10;
+export const MAX_FEE_BPS = 1_000;
+
+export const FLAG_SETTLED = 1;
+export const FLAG_CLOSED = 2;
+
+export const SETTLE_DELAY = 32n;
+
+export const HEADER_OFFSET = {
+  tag: 0,
+  version: 1,
+  bump: 2,
+  flags: 3,
+  maxSupply: 4,
+  minted: 6,
+  feeBps: 8,
+  nonce: 12,
+  mintPrice: 16,
+  creator: 24,
+  treasury: 56,
+  closeSlot: 88,
+  entropy: 152,
+  generatorHash: 184,
+} as const;
+
+export const SLOT_OFFSET = {
+  owner: 0,
+  price: 32,
+} as const;

package/src/errors.ts

@@ -0,0 +1,89 @@
+import { isSolanaError, SOLANA_ERROR__INSTRUCTION_ERROR__CUSTOM, type Address } from "@solana/kit";
+import { SYSTEM_PROGRAM } from "./constants.ts";
+
+export const ERR = {
+  SoldOut: 1,
+  BadBatch: 2,
+  NotOwner: 3,
+  NotListed: 4,
+  PriceAboveMax: 5,
+  SellerMismatch: 6,
+  SelfBuy: 7,
+  NotClosed: 8,
+  AlreadySettled: 9,
+  MintClosed: 10,
+  BadFee: 11,
+  BadSupply: 12,
+  WrongCreator: 13,
+  WrongTreasury: 14,
+  BadId: 15,
+  SameOwner: 16,
+  BadSysvar: 17,
+  TooEarly: 18,
+} as const;
+
+export type ErrorName = keyof typeof ERR;
+
+const NAMES = new Map<number, ErrorName>(Object.entries(ERR).map(([k, v]) => [v, k as ErrorName]));
+
+export const errorName = (code: number): ErrorName | undefined => NAMES.get(code);
+
+export interface ProgramError {
+  code: number;
+  name: ErrorName | undefined;
+  program?: Address;
+  instructionIndex?: number;
+}
+
+const FAILED = /^Program (\w+) failed: custom program error: 0x([0-9a-f]+)/i;
+const CUSTOM = /custom program error: 0x([0-9a-f]+)/i;
+
+function chain(error: unknown): unknown[] {
+  const out: unknown[] = [];
+  for (let e = error, depth = 0; e != null && depth < 8; depth++) {
+    out.push(e);
+    e = typeof e === "object" ? (e as { cause?: unknown }).cause : undefined;
+  }
+  return out;
+}
+
+function logsOf(error: unknown): string[] {
+  if (Array.isArray(error)) return error.filter((l): l is string => typeof l === "string");
+  for (const e of chain(error)) {
+    const logs = (e as { context?: { logs?: unknown } })?.context?.logs ?? (e as { logs?: unknown })?.logs;
+    if (Array.isArray(logs)) return logs.filter((l): l is string => typeof l === "string");
+  }
+  return [];
+}
+
+function named(code: number, program: Address | undefined, programId: Address | undefined): ErrorName | undefined {
+  if (program === undefined) return errorName(code);
+  if (programId !== undefined) return program === programId ? errorName(code) : undefined;
+  return program === SYSTEM_PROGRAM ? undefined : errorName(code);
+}
+
+export function parseProgramError(error: unknown, options: { programId?: Address } = {}): ProgramError | null {
+  for (const line of logsOf(error)) {
+    const m = FAILED.exec(line);
+    if (m) {
+      const program = m[1] as Address;
+      const code = Number.parseInt(m[2], 16);
+      return { code, name: named(code, program, options.programId), program };
+    }
+  }
+  for (const e of chain(error)) {
+    if (isSolanaError(e, SOLANA_ERROR__INSTRUCTION_ERROR__CUSTOM)) {
+      const { code, index } = e.context;
+      return { code, name: errorName(code), instructionIndex: index };
+    }
+  }
+  for (const e of chain(error)) {
+    const text = typeof e === "string" ? e : e instanceof Error ? e.message : "";
+    const m = CUSTOM.exec(text);
+    if (m) {
+      const code = Number.parseInt(m[1], 16);
+      return { code, name: errorName(code) };
+    }
+  }
+  return null;
+}