@mycelium-ip/react 0.1.0-alpha.0

package/dist/hooks/queries/queryKeys.js

@@ -0,0 +1,44 @@
+/**
+ * Query key factory for TanStack Query.
+ *
+ * Provides a structured, type-safe way to define query keys
+ * for granular cache invalidation.
+ *
+ * @example
+ * ```ts
+ * // Invalidate all mycelium queries
+ * queryClient.invalidateQueries({ queryKey: queryKeys.all });
+ *
+ * // Invalidate specific entity
+ * queryClient.invalidateQueries({ queryKey: queryKeys.entity("123") });
+ *
+ * // Invalidate all IPs
+ * queryClient.invalidateQueries({ queryKey: queryKeys.ips() });
+ * ```
+ */
+export const queryKeys = {
+    /** Root key for all mycelium queries */
+    all: ["mycelium"],
+    /** Key for all entity queries */
+    entities: () => [...queryKeys.all, "entities"],
+    /** Key for a specific entity */
+    entity: (id) => [...queryKeys.entities(), id],
+    /** Key for all IP queries */
+    ips: () => [...queryKeys.all, "ips"],
+    /** Key for a specific IP */
+    ip: (id) => [...queryKeys.ips(), id],
+    /** Key for all license queries */
+    licenses: () => [...queryKeys.all, "licenses"],
+    /** Key for a specific license */
+    license: (id) => [...queryKeys.licenses(), id],
+    /** Key for all grant queries */
+    grants: () => [...queryKeys.all, "grants"],
+    /** Key for a specific grant */
+    grant: (id) => [...queryKeys.grants(), id],
+    /** Key for all metadata queries */
+    metadata: () => [...queryKeys.all, "metadata"],
+    /** Key for all derivative queries */
+    derivatives: () => [...queryKeys.all, "derivatives"],
+    /** Key for a specific derivative */
+    derivative: (id) => [...queryKeys.derivatives(), id],
+};

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { useCreateDerivativeLink } from "./hooks/derivative/useCreateDerivativeLink";
+export { useUpdateDerivativeLicense } from "./hooks/derivative/useUpdateDerivativeLicense";
+export { useCreateEntity } from "./hooks/entity/useCreateEntity";
+export { useUpdateEntityControllers } from "./hooks/entity/useUpdateEntityControllers";
+export { useCreateLicenseGrant } from "./hooks/grant/useCreateLicenseGrant";
+export { useRevokeLicenseGrant } from "./hooks/grant/useRevokeLicenseGrant";
+export { useMyceliumClient } from "./hooks/internal/useMyceliumClient";
+export { useMyceliumConnection } from "./hooks/internal/useMyceliumConnection";
+export { useMyceliumContext } from "./hooks/internal/useMyceliumContext";
+export { useMyceliumWallet } from "./hooks/internal/useMyceliumWallet";
+export { useCreateIp } from "./hooks/ip/useCreateIp";
+export { useTransferIp } from "./hooks/ip/useTransferIp";
+export { useCreateLicense } from "./hooks/license/useCreateLicense";
+export { useRevokeLicense } from "./hooks/license/useRevokeLicense";
+export { useUpdateLicense } from "./hooks/license/useUpdateLicense";
+export { useCreateEntityMetadata } from "./hooks/metadata/useCreateEntityMetadata";
+export { useCreateIpMetadata } from "./hooks/metadata/useCreateIpMetadata";
+export { useCreateMetadataSchema } from "./hooks/metadata/useCreateMetadataSchema";
+export { queryKeys } from "./hooks/queries/queryKeys";
+export type { MyceliumContextValue } from "./provider/context";
+export { MyceliumIpProvider, type MyceliumIpProviderOptions, type MyceliumIpProviderProps, } from "./provider/MyceliumIpProvider";
+export type { MyceliumWallet } from "./types/wallet";
+export { executeTransaction, executeTransactionWithInstructions, type TransactionResult, } from "./utils/transaction";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAE3F,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAEvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,kCAAkC,EAClC,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+// This file defines the entire public SDK surface.
+// Do not export internal modules directly.
+// Provider
+// Derivative mutation hooks
+export { useCreateDerivativeLink } from "./hooks/derivative/useCreateDerivativeLink";
+export { useUpdateDerivativeLicense } from "./hooks/derivative/useUpdateDerivativeLicense";
+// Entity mutation hooks
+export { useCreateEntity } from "./hooks/entity/useCreateEntity";
+export { useUpdateEntityControllers } from "./hooks/entity/useUpdateEntityControllers";
+// Grant mutation hooks
+export { useCreateLicenseGrant } from "./hooks/grant/useCreateLicenseGrant";
+export { useRevokeLicenseGrant } from "./hooks/grant/useRevokeLicenseGrant";
+// Internal accessor hooks
+export { useMyceliumClient } from "./hooks/internal/useMyceliumClient";
+export { useMyceliumConnection } from "./hooks/internal/useMyceliumConnection";
+export { useMyceliumContext } from "./hooks/internal/useMyceliumContext";
+export { useMyceliumWallet } from "./hooks/internal/useMyceliumWallet";
+// IP mutation hooks
+export { useCreateIp } from "./hooks/ip/useCreateIp";
+export { useTransferIp } from "./hooks/ip/useTransferIp";
+// License mutation hooks
+export { useCreateLicense } from "./hooks/license/useCreateLicense";
+export { useRevokeLicense } from "./hooks/license/useRevokeLicense";
+export { useUpdateLicense } from "./hooks/license/useUpdateLicense";
+export { useCreateEntityMetadata } from "./hooks/metadata/useCreateEntityMetadata";
+export { useCreateIpMetadata } from "./hooks/metadata/useCreateIpMetadata";
+// Metadata mutation hooks
+export { useCreateMetadataSchema } from "./hooks/metadata/useCreateMetadataSchema";
+// Query keys
+export { queryKeys } from "./hooks/queries/queryKeys";
+export { MyceliumIpProvider, } from "./provider/MyceliumIpProvider";
+// Utilities
+export { executeTransaction, executeTransactionWithInstructions, } from "./utils/transaction";

package/dist/provider/MyceliumIpProvider.d.ts

@@ -0,0 +1,56 @@
+import type { Commitment, Connection } from "@solana/web3.js";
+import { QueryClient } from "@tanstack/react-query";
+import { type ReactNode } from "react";
+import type { MyceliumWallet } from "../types/wallet";
+/**
+ * Options for the MyceliumIpProvider.
+ */
+export interface MyceliumIpProviderOptions {
+    /**
+     * Transaction confirmation level.
+     * @default "confirmed"
+     */
+    confirmation?: Commitment;
+    /**
+     * Enable TanStack Query devtools.
+     * @default true in development, false in production
+     */
+    devtools?: boolean;
+}
+/**
+ * Props for the MyceliumIpProvider component.
+ */
+export interface MyceliumIpProviderProps {
+    /** Solana RPC connection (required) */
+    connection: Connection;
+    /** Wallet implementing the MyceliumWallet interface (required) */
+    wallet: MyceliumWallet;
+    /**
+     * Existing TanStack Query client.
+     * If omitted, the provider creates one.
+     */
+    queryClient?: QueryClient;
+    /** Provider options */
+    options?: MyceliumIpProviderOptions;
+    /** Child components */
+    children: ReactNode;
+}
+/**
+ * Provider component for the Mycelium React SDK.
+ *
+ * Initializes the core SDK client and provides it via React context.
+ * Also wraps children with TanStack Query's QueryClientProvider.
+ *
+ * @example
+ * ```tsx
+ * <MyceliumIpProvider
+ *   connection={connection}
+ *   wallet={wallet}
+ *   options={{ confirmation: "confirmed" }}
+ * >
+ *   <App />
+ * </MyceliumIpProvider>
+ * ```
+ */
+export declare function MyceliumIpProvider({ connection, wallet, queryClient, options, children, }: MyceliumIpProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MyceliumIpProvider.d.ts.map

package/dist/provider/MyceliumIpProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MyceliumIpProvider.d.ts","sourceRoot":"","sources":["../../src/provider/MyceliumIpProvider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,UAAU,EAAE,UAAU,CAAC;IAEvB,kEAAkE;IAClE,MAAM,EAAE,cAAc,CAAC;IAEvB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,uBAAuB;IACvB,OAAO,CAAC,EAAE,yBAAyB,CAAC;IAEpC,uBAAuB;IACvB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,UAAU,EACV,MAAM,EACN,WAAW,EACX,OAAO,EACP,QAAQ,GACT,EAAE,uBAAuB,2CA0DzB"}

package/dist/provider/MyceliumIpProvider.js

@@ -0,0 +1,76 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MyceliumClient } from "@mycelium-ip/core-sdk";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
+import { useMemo } from "react";
+import { MyceliumContext } from "./context";
+// Default query client with sensible defaults
+const createDefaultQueryClient = () => new QueryClient({
+    defaultOptions: {
+        queries: {
+            staleTime: 1000 * 60 * 5, // 5 minutes
+            retry: 1,
+        },
+    },
+});
+/**
+ * Provider component for the Mycelium React SDK.
+ *
+ * Initializes the core SDK client and provides it via React context.
+ * Also wraps children with TanStack Query's QueryClientProvider.
+ *
+ * @example
+ * ```tsx
+ * <MyceliumIpProvider
+ *   connection={connection}
+ *   wallet={wallet}
+ *   options={{ confirmation: "confirmed" }}
+ * >
+ *   <App />
+ * </MyceliumIpProvider>
+ * ```
+ */
+export function MyceliumIpProvider({ connection, wallet, queryClient, options, children, }) {
+    var _a, _b;
+    const confirmation = (_a = options === null || options === void 0 ? void 0 : options.confirmation) !== null && _a !== void 0 ? _a : "confirmed";
+    const showDevtools = (_b = options === null || options === void 0 ? void 0 : options.devtools) !== null && _b !== void 0 ? _b : false;
+    // Create a default query client if none provided
+    const resolvedQueryClient = useMemo(() => queryClient !== null && queryClient !== void 0 ? queryClient : createDefaultQueryClient(), [queryClient]);
+    // Create the core SDK client
+    const client = useMemo(() => {
+        var _a;
+        // Only create client if wallet has a public key
+        if (!wallet.publicKey) {
+            return null;
+        }
+        return new MyceliumClient({
+            connection,
+            wallet: {
+                publicKey: wallet.publicKey,
+                signTransaction: (tx) => wallet.signTransaction(tx),
+                signAllTransactions: (_a = wallet.signAllTransactions) !== null && _a !== void 0 ? _a : (async (txs) => {
+                    const signed = [];
+                    for (const tx of txs) {
+                        signed.push(await wallet.signTransaction(tx));
+                    }
+                    return signed;
+                }),
+                signMessage: wallet.signMessage,
+            },
+        });
+    }, [connection, wallet]);
+    // Create context value
+    const contextValue = useMemo(() => {
+        if (!client) {
+            return null;
+        }
+        return {
+            connection,
+            wallet,
+            client,
+            confirmation,
+        };
+    }, [connection, wallet, client, confirmation]);
+    return (_jsxs(QueryClientProvider, { client: resolvedQueryClient, children: [_jsx(MyceliumContext.Provider, { value: contextValue, children: children }), showDevtools && _jsx(ReactQueryDevtools, { initialIsOpen: false })] }));
+}

package/dist/provider/context.d.ts

@@ -0,0 +1,22 @@
+import type { MyceliumClient } from "@mycelium-ip/core-sdk";
+import type { Commitment, Connection } from "@solana/web3.js";
+import type { MyceliumWallet } from "../types/wallet";
+/**
+ * Context value provided by MyceliumIpProvider.
+ */
+export interface MyceliumContextValue {
+    /** Solana RPC connection */
+    connection: Connection;
+    /** Wallet implementing the MyceliumWallet interface */
+    wallet: MyceliumWallet;
+    /** Core SDK client instance */
+    client: MyceliumClient;
+    /** Transaction confirmation level */
+    confirmation: Commitment;
+}
+/**
+ * React context for Mycelium SDK.
+ * @internal
+ */
+export declare const MyceliumContext: import("react").Context<MyceliumContextValue | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/provider/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/provider/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,uDAAuD;IACvD,MAAM,EAAE,cAAc,CAAC;IACvB,+BAA+B;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,qCAAqC;IACrC,YAAY,EAAE,UAAU,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,sDAAmD,CAAC"}

package/dist/provider/context.js

@@ -0,0 +1,6 @@
+import { createContext } from "react";
+/**
+ * React context for Mycelium SDK.
+ * @internal
+ */
+export const MyceliumContext = createContext(null);

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export type { MyceliumWallet } from "./wallet";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet.d.ts

@@ -0,0 +1,54 @@
+import type { PublicKey, Transaction, VersionedTransaction } from "@solana/web3.js";
+/**
+ * Wallet-agnostic interface for transaction signing.
+ *
+ * This interface allows consumers to adapt any wallet implementation
+ * (Solana Wallet Adapter, Privy, embedded wallets) without introducing
+ * direct dependencies on specific wallet libraries.
+ *
+ * @example Solana Wallet Adapter
+ * ```ts
+ * const wallet: MyceliumWallet = {
+ *   publicKey: walletAdapter.publicKey,
+ *   signTransaction: walletAdapter.signTransaction,
+ *   signAllTransactions: walletAdapter.signAllTransactions,
+ * };
+ * ```
+ *
+ * @example Privy Wallet
+ * ```ts
+ * const wallet: MyceliumWallet = {
+ *   publicKey: new PublicKey(privyWallet.address),
+ *   signTransaction: privyWallet.signTransaction,
+ *   signMessage: privyWallet.signMessage,
+ * };
+ * ```
+ */
+export interface MyceliumWallet {
+    /**
+     * The public key of the connected wallet.
+     * May be null if no wallet is connected.
+     */
+    publicKey: PublicKey | null;
+    /**
+     * Signs a single transaction.
+     * @param transaction - The transaction to sign
+     * @returns The signed transaction
+     */
+    signTransaction<T extends Transaction | VersionedTransaction>(transaction: T): Promise<T>;
+    /**
+     * Signs multiple transactions at once.
+     * Optional - not all wallets support batch signing.
+     * @param transactions - The transactions to sign
+     * @returns The signed transactions
+     */
+    signAllTransactions?<T extends Transaction | VersionedTransaction>(transactions: T[]): Promise<T[]>;
+    /**
+     * Signs an arbitrary message.
+     * Optional - not all wallets support message signing.
+     * @param message - The message bytes to sign
+     * @returns The signature bytes
+     */
+    signMessage?(message: Uint8Array): Promise<Uint8Array>;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/types/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/types/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAE5B;;;;OAIG;IACH,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,oBAAoB,EAC1D,WAAW,EAAE,CAAC,GACb,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd;;;;;OAKG;IACH,mBAAmB,CAAC,CAAC,CAAC,SAAS,WAAW,GAAG,oBAAoB,EAC/D,YAAY,EAAE,CAAC,EAAE,GAChB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhB;;;;;OAKG;IACH,WAAW,CAAC,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACxD"}

package/dist/types/wallet.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/transaction.d.ts

@@ -0,0 +1,40 @@
+import type { Commitment, Connection, TransactionInstruction } from "@solana/web3.js";
+import type { MyceliumWallet } from "../types/wallet";
+/**
+ * Result of executing a transaction.
+ */
+export interface TransactionResult {
+    /** Transaction signature */
+    signature: string;
+}
+/**
+ * Execute the full transaction lifecycle.
+ *
+ * 1. Build transaction from instruction
+ * 2. Set recent blockhash
+ * 3. Sign transaction using wallet
+ * 4. Send transaction to the network
+ * 5. Confirm transaction with specified commitment level
+ *
+ * @param connection - Solana RPC connection
+ * @param wallet - Wallet for signing
+ * @param instruction - Transaction instruction to execute
+ * @param confirmation - Commitment level for confirmation
+ * @returns Transaction signature
+ *
+ * @throws Error if wallet is not connected (no publicKey)
+ */
+export declare function executeTransaction(connection: Connection, wallet: MyceliumWallet, instruction: TransactionInstruction, confirmation: Commitment): Promise<TransactionResult>;
+/**
+ * Execute multiple instructions in a single transaction.
+ *
+ * @param connection - Solana RPC connection
+ * @param wallet - Wallet for signing
+ * @param instructions - Transaction instructions to execute
+ * @param confirmation - Commitment level for confirmation
+ * @returns Transaction signature
+ *
+ * @throws Error if wallet is not connected (no publicKey)
+ */
+export declare function executeTransactionWithInstructions(connection: Connection, wallet: MyceliumWallet, instructions: TransactionInstruction[], confirmation: Commitment): Promise<TransactionResult>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/utils/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,sBAAsB,EACnC,YAAY,EAAE,UAAU,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAkC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kCAAkC,CACtD,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,sBAAsB,EAAE,EACtC,YAAY,EAAE,UAAU,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAqC5B"}

package/dist/utils/transaction.js

@@ -0,0 +1,82 @@
+import { Transaction } from "@solana/web3.js";
+/**
+ * Execute the full transaction lifecycle.
+ *
+ * 1. Build transaction from instruction
+ * 2. Set recent blockhash
+ * 3. Sign transaction using wallet
+ * 4. Send transaction to the network
+ * 5. Confirm transaction with specified commitment level
+ *
+ * @param connection - Solana RPC connection
+ * @param wallet - Wallet for signing
+ * @param instruction - Transaction instruction to execute
+ * @param confirmation - Commitment level for confirmation
+ * @returns Transaction signature
+ *
+ * @throws Error if wallet is not connected (no publicKey)
+ */
+export async function executeTransaction(connection, wallet, instruction, confirmation) {
+    if (!wallet.publicKey) {
+        throw new Error("Wallet not connected");
+    }
+    // Build the transaction
+    const transaction = new Transaction().add(instruction);
+    // Get latest blockhash
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash(confirmation);
+    transaction.recentBlockhash = blockhash;
+    transaction.feePayer = wallet.publicKey;
+    // Sign the transaction
+    const signed = await wallet.signTransaction(transaction);
+    // Send the transaction
+    const signature = await connection.sendRawTransaction(signed.serialize(), {
+        skipPreflight: false,
+        preflightCommitment: confirmation,
+    });
+    // Confirm the transaction
+    await connection.confirmTransaction({
+        signature,
+        blockhash,
+        lastValidBlockHeight,
+    }, confirmation);
+    return { signature };
+}
+/**
+ * Execute multiple instructions in a single transaction.
+ *
+ * @param connection - Solana RPC connection
+ * @param wallet - Wallet for signing
+ * @param instructions - Transaction instructions to execute
+ * @param confirmation - Commitment level for confirmation
+ * @returns Transaction signature
+ *
+ * @throws Error if wallet is not connected (no publicKey)
+ */
+export async function executeTransactionWithInstructions(connection, wallet, instructions, confirmation) {
+    if (!wallet.publicKey) {
+        throw new Error("Wallet not connected");
+    }
+    // Build the transaction with all instructions
+    const transaction = new Transaction();
+    for (const ix of instructions) {
+        transaction.add(ix);
+    }
+    // Get latest blockhash
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash(confirmation);
+    transaction.recentBlockhash = blockhash;
+    transaction.feePayer = wallet.publicKey;
+    // Sign the transaction
+    const signed = await wallet.signTransaction(transaction);
+    // Send the transaction
+    const signature = await connection.sendRawTransaction(signed.serialize(), {
+        skipPreflight: false,
+        preflightCommitment: confirmation,
+    });
+    // Confirm the transaction
+    await connection.confirmTransaction({
+        signature,
+        blockhash,
+        lastValidBlockHeight,
+    }, confirmation);
+    return { signature };
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@mycelium-ip/react",
+  "version": "0.1.0-alpha.0",
+  "private": false,
+  "type": "module",
+  "description": "React hooks for the Mycelium IP protocol",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "biome check .",
+    "test": "vitest",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "solana",
+    "ip",
+    "mycelium",
+    "react",
+    "hooks"
+  ],
+  "author": "mycelium-dev",
+  "license": "MIT",
+  "packageManager": "pnpm@10.12.1",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@mycelium-ip/core-sdk": "workspace:^"
+  },
+  "peerDependencies": {
+    "@solana/web3.js": ">=1.87.0",
+    "@tanstack/react-query": ">=5.0.0",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@solana/web3.js": "^1.98.0",
+    "@tanstack/react-query": "^5.76.2",
+    "@tanstack/react-query-devtools": "^5.76.2",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^26.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "vitest": "^3.1.1"
+  }
+}