fix(sdk,core): re-export torii types and type DojoProvider manifest (#521)

* fix(sdk,core): re-export torii namespace and type DojoProvider manifest

Fixes #482 — torii-wasm types (Subscription, TokenBalance, etc.) are
now re-exported from @dojoengine/sdk via the `torii` namespace for
both web and node entry points.

Also replaces `manifest: any` in DojoProvider and utility functions
with a proper `DojoManifest` interface that captures what the provider
actually reads from the manifest object.

* fix(core): address CodeRabbit review — Abi cast and JSDoc types

---------

Co-authored-by: Thierry <thierry@openclaw.ai>

Author: MartianGreed

packages/core/src/provider/DojoProvider.ts

@@ -1,4 +1,5 @@
 import {
+    type Abi,
     type Account,
     type AccountInterface,
     type AllowArray,
@@ -15,7 +16,7 @@ import {
 
 import { LOCAL_KATANA } from "../constants";
 import { ConsoleLogger, type LogLevel } from "../logger/logger";
-import { type DojoCall, WorldEntryPoints } from "../types";
+import { type DojoCall, type DojoManifest, WorldEntryPoints } from "../types";
 import { compileDojoCalldata } from "../utils/compile";
 import { getContractAbi, getContractByName, parseDojoCall } from "../utils";
 import { Provider } from "./provider";
@@ -101,17 +102,17 @@ type ActionMethodImplementation = (
 class DojoProviderBase extends Provider {
     public provider: RpcProvider;
     public contract: Contract;
-    public manifest: any;
+    public manifest: DojoManifest;
     public logger: ConsoleLogger;
 
     /**
      * Constructor: Initializes the DojoProvider with the given world address, manifest and URL.
      *
-     * @param {string} world_address - Address of the world.
+     * @param {DojoManifest} manifest - The Dojo manifest object.
      * @param {string} [url=LOCAL_KATANA] - RPC URL (defaults to LOCAL_KATANA).
      */
     constructor(
-        manifest?: any,
+        manifest: DojoManifest,
         url: string = LOCAL_KATANA,
         logLevel: LogLevel = "none"
     ) {
@@ -121,7 +122,7 @@ class DojoProviderBase extends Provider {
         });
 
         this.contract = new Contract({
-            abi: manifest.world.abi ?? manifest.abis ?? [],
+            abi: (manifest.world.abi ?? manifest.abis ?? []) as Abi,
             address: this.getWorldAddress(),
             providerOrAccount: this.provider,
         });
@@ -292,13 +293,24 @@ class DojoProviderBase extends Provider {
                     nameSpace,
                     call.contractName
                 );
+
+                if (!contractInfos) {
+                    throw new Error(
+                        `Contract "${call.contractName}" not found in namespace "${nameSpace}"`
+                    );
+                }
+
+                const contractAbi = getContractAbi(
+                    this.manifest,
+                    contractInfos
+                );
                 const contract = new Contract({
-                    abi: contractInfos.abi,
+                    abi: contractAbi,
                     address: contractInfos.address,
                     providerOrAccount: this.provider,
                 });
                 const compiledCalldata = compileDojoCalldata(
-                    contractInfos.abi,
+                    contractAbi,
                     nameSpace,
                     call.contractName,
                     call.entrypoint,
@@ -357,9 +369,9 @@ class DojoProviderBase extends Provider {
         >;
 
         const functionCounts = new Map<string, number>();
-        for (const contract of this.manifest.contracts as Array<any>) {
+        for (const contract of this.manifest.contracts ?? []) {
             if (!contract?.systems?.length) continue;
-            for (const systemName of contract.systems as Array<string>) {
+            for (const systemName of contract.systems) {
                 functionCounts.set(
                     systemName,
                     (functionCounts.get(systemName) || 0) + 1
@@ -374,7 +386,7 @@ class DojoProviderBase extends Provider {
             value !== null &&
             "execute" in (value as Record<string, unknown>);
 
-        for (const contract of this.manifest.contracts as Array<any>) {
+        for (const contract of this.manifest.contracts ?? []) {
             if (
                 !contract?.systems?.length ||
                 typeof contract.tag !== "string"
@@ -507,7 +519,7 @@ export type DojoProviderInstance<Actions = never> = DojoProviderBase &
 export type DojoProvider<Actions = never> = DojoProviderInstance<Actions>;
 
 type DojoProviderConstructor = new <Actions = never>(
-    manifest?: any,
+    manifest: DojoManifest,
     url?: string,
     logLevel?: LogLevel
 ) => DojoProvider<Actions>;

packages/core/src/types/index.ts

@@ -133,6 +133,26 @@ export type DojoCall = {
     calldata: RawArgs | Calldata;
 };
 
+/**
+ * Minimal manifest shape consumed by DojoProvider and utility functions.
+ * Supports both legacy (inline ABI) and modern (root-level abis) formats.
+ */
+export interface DojoManifest {
+    world: {
+        address: string;
+        abi?: readonly Record<string, unknown>[];
+    };
+    /** Root-level ABI array (modern format). */
+    abis?: readonly Record<string, unknown>[];
+    contracts?: ReadonlyArray<{
+        tag: string;
+        address: string;
+        systems?: readonly string[];
+        abi?: readonly Record<string, unknown>[];
+    }>;
+    [key: string]: unknown;
+}
+
 /**
  * Cairo to TypeScript type mappings
  */

packages/core/src/utils/index.ts

@@ -1,53 +1,56 @@
 import { Abi, Call, TypedData } from "starknet";
 
-import { DojoCall } from "../types";
+import { DojoCall, DojoManifest } from "../types";
 import { compileDojoCalldata } from "./compile";
 
 /**
  * Gets the ABI for a contract, supporting both old (inline) and new (root-level) manifest formats.
  *
- * @param {any} manifest - The manifest object.
- * @param {any} contract - The contract object.
+ * @param {DojoManifest} manifest - The manifest object.
+ * @param {object} contract - The contract object.
  * @returns {Abi} The ABI array.
  */
-export const getContractAbi = (manifest: any, contract: any): Abi => {
+export const getContractAbi = (
+    manifest: DojoManifest,
+    contract: { abi?: readonly Record<string, unknown>[] }
+): Abi => {
     if (Array.isArray(contract?.abi) && contract.abi.length > 0) {
-        return contract.abi;
+        return contract.abi as Abi;
     }
     if (Array.isArray(manifest?.abis)) {
-        return manifest.abis;
+        return manifest.abis as Abi;
     }
     return [];
 };
 
 /**
  * Gets a contract from a manifest by name.
  *
- * @param {any} manifest - The manifest object.
+ * @param {DojoManifest} manifest - The manifest object.
+ * @param {string} nameSpace - The namespace of the contract.
  * @param {string} name - The name of the contract.
- * @returns {any} The contract object.
- *
+ * @returns The contract object, or undefined if not found.
  */
 export const getContractByName = (
-    manifest: any,
+    manifest: DojoManifest,
     nameSpace: string,
     name: string
 ) => {
-    return manifest.contracts.find((contract: any) => {
+    return (manifest.contracts ?? []).find((contract) => {
         return contract.tag === nameSpace + "-" + name;
     });
 };
 
 /**
  * Convert a DojoCall to a Call replacing contractName with contractAddress
  *
- * @param {any} manifest - The manifest object.
+ * @param {DojoManifest} manifest - The manifest object.
  * @param {DojoCall | Call} call - A DojoCall or Call
  * @returns {Call} The contract object.
  *
  */
 export const parseDojoCall = (
-    manifest: any,
+    manifest: DojoManifest,
     nameSpace: string,
     call: DojoCall | Call
 ): Call => {

packages/sdk/src/node/index.ts

@@ -11,6 +11,7 @@ import {
 import { createSDK, type GrpcClientInterface } from "../createSDK.js";
 
 export * from "@dojoengine/internal";
+export { torii };
 export * from "./worker.ts";
 export { initGrpc, type InitGrpcOptions } from "../initGrpc.js";
 export type { GrpcClientInterface } from "../createSDK.js";

packages/sdk/src/web/index.ts

@@ -10,6 +10,7 @@ import {
 import { createSDK, type GrpcClientInterface } from "../createSDK.js";
 
 export * from "@dojoengine/internal";
+export { torii };
 export { initGrpc, type InitGrpcOptions } from "../initGrpc.js";
 export type { GrpcClientInterface } from "../createSDK.js";