@deloraprotocol/widget 1.0.0 → 1.0.1

package/README.md

@@ -20,26 +20,29 @@ import "@deloraprotocol/widget/styles.css";
 
 ## Usage
 
-### Trade Widget
-
-```tsx
+### Trade Widget
+
+```tsx
 import { TradeWidget } from "@deloraprotocol/widget";
-
-<TradeWidget
-  theme="dark"
-  config={{
-    dataBaseUrl: "https://your-app.com",  // or "" for same-origin
-    apiBase: "https://api.delora.build",
-  }}
-/>
-```
-
-`dataBaseUrl` must point to a server that hosts:
-- `/data/networks.json`
-- `/data/tokens.json`
-- `/data/tokens_search.json`
-
-Use `""` for same-origin (e.g. when data is in your app's public folder).
+
+<TradeWidget
+  theme="dark"
+  config={{
+    apiBase: "https://api.delora.build",
+  }}
+/>
+```
+
+`apiBase` is used for:
+- `/v1/chains`
+- `/v1/tokens`
+- `/v1/quotes`
+
+If omitted, the widget defaults to `https://api.delora.build`.
+
+`dataBaseUrl` is no longer required for metadata fetching. Keep it only if you need
+to resolve relative image URLs from a custom source. For explicit control over image
+resolution, pass `assetBaseUrl`.
 
 ### Simple Widget (MyWidget)
 
@@ -161,7 +164,7 @@ cd playground && npm install
 npm run playground:dev
 ```
 
-This runs the library watcher and the playground dev server together. The playground uses the built output from `dist/`.
+This runs the library watcher and the playground dev server together. The playground uses the built output from `dist/`.
 
 **When errors occur or the UI shows stale/broken code:** run `npm run build` separately to rebuild the library, then restart or refresh the playground. The playground does not auto-rebuild the library.
 

package/dist/index.d.ts

@@ -62,9 +62,11 @@ export declare interface Token {
 export declare function TradeWidget(props: TradeWidgetProps): JSX.Element;
 
 export declare interface TradeWidgetConfig {
-    dataBaseUrl: string;
+    /** Legacy asset base or custom relative-image base. Metadata is loaded from apiBase/v1/... */
+    dataBaseUrl?: string;
+    /** Base URL of Delora API used for chains, tokens, and quotes. Defaults to https://api.delora.build */
     apiBase?: string;
-    /** Base URL for resolving relative image paths (e.g. /img/...). Defaults to dataBaseUrl or origin. */
+    /** Base URL for resolving relative image paths (e.g. /img/...). Defaults to dataBaseUrl, apiBase, or origin. */
     assetBaseUrl?: string;
     /** Whether a wallet is connected. When false, the main button shows "Connect Wallet" (Angular: isWalletConnected). */
     isWalletConnected?: boolean;