@direct.dev/sdk 1.0.1 → 1.0.2

package/README.md

@@ -47,7 +47,7 @@ import { install } from "@direct.dev/sdk";
 
 install();
 
-const res = await fetch("https://rpc.direct.dev/v1/<projectId>.<token>/ethereum", {
+const res = await fetch("https://rpc.direct.dev/v1/<project>.<token>/ethereum", {
   method: "POST",
   headers: { "Content-Type": "application/json" },
   body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "eth_blockNumber", params: [] }),
@@ -78,7 +78,7 @@ const directFetch = createFetch({
   logging: { client: "info" },
 });
 
-const res = await directFetch("https://rpc.direct.dev/v1/<projectId>.<token>/ethereum", {
+const res = await directFetch("https://rpc.direct.dev/v1/<project>.<token>/ethereum", {
   method: "POST",
   headers: { "Content-Type": "application/json" },
   body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "eth_blockNumber", params: [] }),
@@ -102,7 +102,7 @@ install();
 
 const client = createPublicClient({
   chain: mainnet,
-  transport: http("https://rpc.direct.dev/v1/<projectId>.<token>/ethereum"),
+  transport: http("https://rpc.direct.dev/v1/<project>.<token>/ethereum"),
 });
 
 await client.getBlockNumber();
@@ -119,7 +119,7 @@ const directFetch = createFetch({ logging: { client: "info" } });
 
 const client = createPublicClient({
   chain: mainnet,
-  transport: http("https://rpc.direct.dev/v1/<projectId>.<token>/ethereum", {
+  transport: http("https://rpc.direct.dev/v1/<project>.<token>/ethereum", {
     fetch: directFetch,
   }),
 });
@@ -136,7 +136,7 @@ In the browser, prefer an HTML preload link. It lets the browser start fetching
   rel="preload"
   as="fetch"
   crossorigin="anonymous"
-  href="https://rpc.direct.dev/v1/<projectId>.<token>/ethereum"
+  href="https://rpc.direct.dev/v1/<project>.<token>/ethereum"
 />
 ```
 
@@ -145,8 +145,8 @@ On the server, or in environments without preload links, pass `preload` to `inst
 ```ts
 install({
   preload: [
-    "https://rpc.direct.dev/v1/<projectId>.<token>/ethereum",
-    "https://rpc.direct.dev/v1/<projectId>.<token>/sonic",
+    "https://rpc.direct.dev/v1/<project>.<token>/ethereum",
+    "https://rpc.direct.dev/v1/<project>.<token>/sonic",
   ],
 });
 ```
@@ -199,7 +199,7 @@ The `logging` option covers three independent concerns:
 | `silent` | Nothing. |
 | `error` | Errors only. `[direct:ERROR] Batch contains duplicate request IDs { ids: [1, 1] }` |
 | `warn` | Errors + warnings. `[direct:WARN] Request failed { input: ..., err: ... }` |
-| `info` | Reserved for sparse operational summaries. No default emissions yet. |
+| `info` | Sparse operational summaries, including live sync connection state. |
 | `debug` | Full lifecycle: preload, sync, client phases. |
 
 Example debug output:
@@ -215,6 +215,27 @@ Example debug output:
   client_instance_id: "client_ethereum_f47ac10b_1",
   network_id: "ethereum"
 }
+[direct:INFO] sync.connection {
+  client_instance_id: "client_ethereum_f47ac10b_1",
+  network_id: "ethereum",
+  connected: true,
+  transport: "wire_socket",
+  reason: "started"
+}
+[direct:INFO] sync.ready {
+  client_instance_id: "client_ethereum_f47ac10b_1",
+  network_id: "ethereum",
+  ready: true,
+  transport: "wire_socket",
+  reason: "block_state_available",
+  current_block_height: "0x134a1c0"
+}
+[direct:INFO] block.advanced {
+  client_instance_id: "client_ethereum_f47ac10b_1",
+  network_id: "ethereum",
+  source: "wire_socket",
+  current_block_height: "0x134a1c1"
+}
 ```
 
 ### `logging.requests`
@@ -289,6 +310,9 @@ type LogEvent = {
 - `preload.phase`
 - `preload.clock_sync`
 - `sync.rebuild`
+- `sync.connection`
+- `sync.ready`
+- `block.advanced`
 - `client.phase`
 
 **Debug-only diagnostics** — only emitted when the relevant log level is active:
@@ -304,7 +328,7 @@ The SDK exports `LogEvent`, `LoggingOptions`, and `CreateFetchOptions` for typed
 The SDK intercepts a special JSON-RPC method, `direct_client_status`, and answers it locally without touching the network. Useful for debugging your integration:
 
 ```ts
-const res = await fetch("https://rpc.direct.dev/v1/<projectId>.<token>/ethereum", {
+const res = await fetch("https://rpc.direct.dev/v1/<project>.<token>/ethereum", {
   method: "POST",
   headers: { "Content-Type": "application/json" },
   body: JSON.stringify({
@@ -330,9 +354,9 @@ const { result } = await res.json();
 
 The SDK only takes over POST requests whose body is JSON-RPC and whose URL matches a Direct.dev RPC endpoint:
 
-- `https://rpc.direct.dev/v1/<projectId>.<token>/<networkId>`
-- `https://staging.rpc.direct.dev/v1/<projectId>.<token>/<networkId>`
-- `https://prod.rpc.direct.dev/v1/<projectId>.<token>/<networkId>`
+- `https://rpc.direct.dev/v1/<project>.<token>/<network>`
+- `https://staging.rpc.direct.dev/v1/<project>.<token>/<network>`
+- `https://prod.rpc.direct.dev/v1/<project>.<token>/<network>`
 
 ## License