Allowing configuration of http client of HttpApp

Author: tuler

.changeset/chilly-snakes-cheat.md

@@ -0,0 +1,5 @@
+---
+"@deroll/app": patch
+---
+
+changing createApp param name from url to baseUrl

.changeset/public-steaks-find.md

@@ -0,0 +1,6 @@
+---
+"@deroll/create-app": patch
+"@deroll/examples": patch
+---
+
+exposing ClientOptions at HttpApp

README.md

@@ -36,22 +36,22 @@ import { createApp } from "@deroll/app";
 
 // Create the application
 const app = createApp({
-    url: process.env.ROLLUP_HTTP_SERVER_URL || "http://127.0.0.1:5004",
+  baseUrl: process.env.ROLLUP_HTTP_SERVER_URL || "http://127.0.0.1:5004",
 });
 
 // Handle input encoded in hex
 app.addAdvanceHandler(async ({ payload }) => {
-    // read payload as string
-    const str = hexToString(payload);
+  // read payload as string
+  const str = hexToString(payload);
 
-    // create a notice with the string in uppercase
-    await app.createNotice({ payload: stringToHex(str.toUpperCase()) });
+  // create a notice with the string in uppercase
+  await app.createNotice({ payload: stringToHex(str.toUpperCase()) });
 });
 
 // Start the application
 app.start().catch((e) => {
-    console.error(e);
-    process.exit(1);
+  console.error(e);
+  process.exit(1);
 });
 ```
 
@@ -82,9 +82,9 @@ cartesi send
 1. Choose `Send generic input to the application.`
 2. After choose `Foundry`
 3. Select the defaults:
-    1. Select the RPC URL `http://127.0.0.1:8545`
-    2. Select Mnemonic
-    3. Account, DApp address
+   1. Select the RPC URL `http://127.0.0.1:8545`
+   2. Select Mnemonic
+   3. Account, DApp address
 4. Select `Input String encoding` and in the input type `Hello world!` and hit enter.
 
 Expected output:
@@ -106,6 +106,7 @@ cartesi send
 Expected output in the `cartesi rollups logs` terminal:
 
 ```shell
+
 ```
 
 Now you're ready to start building your Cartesi application with cartesi and deroll!
@@ -114,8 +115,8 @@ Now you're ready to start building your Cartesi application with cartesi and der
 
 ### Requirements
 
--   Corepack (with pnpm) or pnpm v9 (9.7.1 recommended)
--   Node 20 or greater (LTS)
+- Corepack (with pnpm) or pnpm v9 (9.7.1 recommended)
+- Node 20 or greater (LTS)
 
 ### Installation
 

apps/docs/pages/advance-handlers.mdx

@@ -17,7 +17,7 @@ const handler: AdvanceRequestHandler = async ({ metadata, payload }) => {
 }
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 app.addAdvanceHandler(handler);
 ```
 
@@ -31,7 +31,7 @@ By default, when a handler returns `"accept"` the execution chain stops.
 import { createApp } from "@deroll/app";
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 
 // ---cut---
 app.addAdvanceHandler(async (data) => {
@@ -51,7 +51,7 @@ If a handler returns `"reject"` or **raises an exception**, the next handler in
 import { createApp } from "@deroll/app";
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 
 // ---cut---
 app.addAdvanceHandler(async (data) => {
@@ -76,7 +76,7 @@ import { createApp } from "@deroll/app";
 
 // create application
 const app = createApp({
-    url: "http://127.0.0.1:5004",
+    baseUrl: "http://127.0.0.1:5004",
     broadcastAdvanceRequests: true
 //  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 });

apps/docs/pages/app/add-advance-handler.mdx

@@ -10,7 +10,7 @@ Below is a simple example of adding an advance handler that only logs the reques
 import { createApp } from "@deroll/app";
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 
 app.addAdvanceHandler(async ({ metadata, payload }) => { // [!code focus]
     console.log(metadata, payload); // [!code focus]

apps/docs/pages/app/add-inspect-handler.mdx

@@ -10,7 +10,7 @@ Below is a simple example of adding an inspect handler that only logs the reques
 import { createApp } from "@deroll/app";
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 
 app.addInspectHandler(async ({ payload }) => { // [!code focus]
     console.log(payload); // [!code focus]

apps/docs/pages/app/create-app.mdx

@@ -10,7 +10,7 @@ Below is a simple example of constructing a new `App` that fetches requests from
 import { createApp } from "@deroll/app";
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 ```
 
 ## Returns

apps/docs/pages/app/create-notice.mdx

@@ -11,7 +11,7 @@ import { createApp } from "@deroll/app";
 import { stringToHex } from "viem";
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 
 // log incoming advance request
 app.addAdvanceHandler(async (data) => {

apps/docs/pages/app/create-report.mdx

@@ -13,7 +13,7 @@ import { createApp } from "@deroll/app";
 import { stringToHex } from "viem";
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 
 // log incoming advance request
 app.addAdvanceHandler(async (data) => {

apps/docs/pages/app/create-voucher.mdx

@@ -11,7 +11,7 @@ import { createApp } from "@deroll/app";
 import { encodeFunctionData, erc20Abi, parseUnits } from "viem";
 
 // create application
-const app = createApp({ url: "http://127.0.0.1:5004" });
+const app = createApp({ baseUrl: "http://127.0.0.1:5004" });
 
 // log incoming advance request
 app.addAdvanceHandler(async (data) => {