Onchain OS

https://web3.okx.com/onchainos/dev-docs
Admin
Onchain OS is a Web3 infrastructure platform combining AI-native agentic wallets, DEX aggregation,...
Tokens:1,218,738
Snippets:6,155
Trust Score:5.8
Update:5 days ago
Show doc for...
Tokens:
Raw
### Initialize Project and Install Dependencies

Source: https://web3.okx.com/onchainos/dev-docs/market/how-to-finish-api-payment

Create the project directory and install the necessary SDKs and TypeScript dependencies.

```bash
mkdir x402-demo && cd x402-demo
npm init -y
npm install --save-dev @types/node
npm install viem @okxweb3/x402-fetch @okxweb3/x402-evm dotenv ts-node typescript
```

--------------------------------

### Connect to wallet and get public key

Source: https://web3.okx.com/onchainos/dev-docs/wallet/dapp-connect/chains/nostr/provider

Example of connecting to the OKX wallet and retrieving the public key using window.okxwallet.nostr.getPublicKey(). The same example appears twice in the source, under 'Simple example of connecting to a wallet' and 'Get public key'.

```JavaScript
try {
  const publicKey = await window.okxwallet.nostr.getPublicKey();
} catch (error) {
  console.log(error);
}
```

--------------------------------

### FileStore Instantiation Example

Source: https://web3.okx.com/onchainos/dev-docs/payments/sdk-go

Example of initializing a FileStore for channel state.

```go
chStore, err := store.NewFileStore[store.ChannelState]("/var/lib/mpp/channels")
```

--------------------------------

### Get Address Information Request

Source: https://web3.okx.com/onchainos/dev-docs/xlayer/developer/data/address-information

Example cURL request to retrieve address information using the GET method.

```shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/address/information-evm?address=0x1e4a5963abfd975d8c9021ce480b42188849d41d&chainShortName=xlayer' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
```

--------------------------------

### Batch Get Transaction Details Request

Source: https://web3.okx.com/onchainos/dev-docs/market/onchaindata-transaction-transaction-multi

Example of a GET request to retrieve details for multiple transaction hashes.

```shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/transaction/transaction-multi?chainIndex=1&txId=0x1e4996d90e77ee87f6a1a2a071603ee5d55d6dd7b272209b741ff276f4a1c34c,0x8e2fbf59e7ffbc0d5cbb2a6e903824adecc9d2a5b78539e0bce9db32adfd85c9' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
```

--------------------------------

### Run one-click setup script

Source: https://web3.okx.com/onchainos/dev-docs/xlayer/developer/flashblocks/node-providers

Downloads and executes the setup script to initialize the RPC node with reth support.

```shell
mkdir -p /data/xlayer-mainnet && cd /data/xlayer-mainnet
curl -fsSL https://raw.githubusercontent.com/okx/xlayer-toolkit/main/rpc-setup/one-click-setup.sh -o one-click-setup.sh
chmod +x one-click-setup.sh
./one-click-setup.sh --rpc_type=reth
```

--------------------------------

### Set up a subscription using SDK or custom orchestration

Source: https://web3.okx.com/onchainos/dev-docs/payments/subscription

This example demonstrates two paths: using the SDK's charge_and_record for automated subscription management, or performing custom orchestration by manually querying and charging subscriptions.

```rust
use std::time::{Duration, SystemTime, UNIX_EPOCH};

fn now_unix() -> u64 {
    SystemTime::now().duration_since(UNIX_EPOCH).map(|d| d.as_secs()).unwrap_or(0)
}

// ── Path A: use the SDK layer (charge_and_record) ──
// due_subscriptions picks active & due subs (needs .with_store); charge_and_record
// charges the period AND reconciles the store (advance nextChargeableAt, migrate
// subId when a downgrade activates). Missed periods aren't backfilled (max 1/charge).
let scheduler = subscription.clone();
tokio::spawn(async move {
    let mut tick = tokio::time::interval(Duration::from_secs(60));
    loop {
        tick.tick().await;
        for rec in scheduler.due_subscriptions(now_unix()).await {
            match scheduler.charge_and_record(&rec.sub_id, true).await {
                Ok(o) if o.plan_change_triggered => {} // downgrade activated -> o.new_sub_id
                Ok(_o) => {}                           // charged: o.period / o.state / o.tx_hash
                Err(_e) => {}                          // dunning: retry / notify / auto-cancel
            }
        }
    }
});

// ── Path B: fully custom orchestration + low-level charge ──
// Drive scheduling/selection/state yourself; call the facilitator's `charge`
// to deduct, and handle ChargeResponse (period/state/txHash/planChangeTriggered) yourself.
use x402_core::subscription::SubscriptionFacilitatorClient;
// `facilitator`: your OkxHttpFacilitatorClient (implements SubscriptionFacilitatorClient).
// You decide which subs are due — query your own store / billing system.
let due_sub_ids: Vec<String> = /* your query */ vec![];
for sub_id in due_sub_ids {
    let _ = facilitator.charge(&sub_id, true).await;
}
```

--------------------------------

### Get Intent Order Status Request

Source: https://web3.okx.com/onchainos/dev-docs/trade/dex-intent-order-status

Example of a GET request to retrieve the status of an intent order using cURL.

```shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/aggregator/intent/order-status?orderUid=0xa1b2c3d4e5f6789012345678901234567890123456789012345678901234567890ab' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
```

--------------------------------

### GET /api/v6/pay/x402/supported Response Example

Source: https://web3.okx.com/onchainos/dev-docs/payments/api-http-onetime

Example JSON response containing the list of supported payment kinds, extensions, and signers.

```json
{
  "code": "0",
  "msg": "",
  "data": {
    "kinds": [
      { "x402Version": 2, "scheme": "exact",         "network": "eip155:196" },
      { "x402Version": 2, "scheme": "exact",         "network": "eip155:196",
        "extra": { "assetTransferMethod": "permit2" } },
      { "x402Version": 2, "scheme": "aggr_deferred", "network": "eip155:196" },
      { "x402Version": 2, "scheme": "upto",          "network": "eip155:196",
        "extra": {
          "assetTransferMethod": "permit2",
          "facilitatorAddress": "0xFacilitatorEOA...",
          "signatureSchemes": ["ed25519", "secp256k1"]
        } }
    ],
    "extensions": [],
    "signers": {}
  }
}
```

--------------------------------

### Construct and register X402ResourceServer

Source: https://web3.okx.com/onchainos/dev-docs/payments/sdk-go

Demonstrates how to initialize the server with options and register multiple EVM schemes on a specific network.

```go
import (
	"github.com/okx/payments/go/x402"
	exact "github.com/okx/payments/go/x402/mechanisms/evm/exact/server"
	deferred "github.com/okx/payments/go/x402/mechanisms/evm/deferred/server"
	uptoserver "github.com/okx/payments/go/x402/mechanisms/evm/upto/server"
)

server := x402.Newx402ResourceServer(
	x402.WithFacilitatorClient(fac),
). 
	Register("eip155:196", exact.NewExactEvmScheme()).        // exact (EIP-3009 / Permit2)
	Register("eip155:196", deferred.NewAggrDeferredEvmScheme()). // aggr_deferred
	Register("eip155:196", uptoserver.NewUptoEvmScheme())     // upto (cap + override)
```

--------------------------------

### Install Onchain OS with npx command

Source: https://web3.okx.com/onchainos/dev-docs/okxai/user-register

Send this command to your agent to install Onchain OS. After installation, open a new session in your agent to start using Onchain OS.

```text
npx -y @okxweb3/onchainos-installer install 
```

--------------------------------

### Set up a subscription in Rust

Source: https://web3.okx.com/onchainos/dev-docs/payments/subscription

This example demonstrates configuring an X402 resource server with an in-memory subscription store, merchant veto hooks, and route-specific plan gating using Axum middleware.

```rust
use std::collections::{HashMap, HashSet};
use std::sync::{Arc, Mutex};
use axum::{routing::get, Json, Router};
use serde_json::{json, Value};
use x402_axum::{
    AccessContext, BeforeAccessResult, InMemorySubscriptionStore, OnBeforeAccessHook,
    PaymentMiddlewareBuilder, RoutePaymentConfig, SubscriptionSupport,
};
use x402_core::http::OkxHttpFacilitatorClient;
use x402_core::server::X402ResourceServer;
use x402_evm::subscription::{PermitSubscriptionScheme, DEFAULT_ACCESS_PROOF_WINDOW_SECS};

#[tokio::main]
async fn main() {
    let api_key    = std::env::var("OKX_API_KEY").expect("OKX_API_KEY required");
    let secret_key = std::env::var("OKX_SECRET_KEY").expect("OKX_SECRET_KEY required");
    let passphrase = std::env::var("OKX_PASSPHRASE").expect("OKX_PASSPHRASE required");
    let pay_to     = std::env::var("PAY_TO_ADDRESS").expect("PAY_TO_ADDRESS required");

    let make_client = || OkxHttpFacilitatorClient::new(&api_key, &secret_key, &passphrase)
        .expect("failed to create facilitator client");

    // Register the period scheme (contract from /supported, or with_subscription_contract).
    let mut server = X402ResourceServer::new(make_client())
        .register("eip155:196", PermitSubscriptionScheme::new());
    server.initialize().await.expect("init failed: check facilitator connectivity");

    // Optional merchant veto: deny a subId (bare 402), before the period gate.
    let denied: Arc<Mutex<HashSet<String>>> = Arc::new(Mutex::new(HashSet::new()));
    let denied_hook = denied.clone();
    let on_before_access: OnBeforeAccessHook = Arc::new(move |ctx: AccessContext| {
        let denied = denied_hook.clone();
        Box::pin(async move {
            let blocked = denied.lock().map(|s| s.contains(&ctx.sub_id)).unwrap_or(false);
            if blocked {
                BeforeAccessResult { abort: true, reason: Some("access denied by merchant".into()) }
            } else {
                BeforeAccessResult::default()
            }
        })
    });

    // Store enables write-after-sync + a 30s access cache; ±300s AccessProof window.
    let subscription = SubscriptionSupport::new(
        Arc::new(make_client()),
        DEFAULT_ACCESS_PROOF_WINDOW_SECS,
    )
    .with_store(Arc::new(InMemorySubscriptionStore::new()))
    .on_before_access(on_before_access);

    // accepts = plan gating: only a sub whose planId is listed is admitted, else 402.
    let routes = HashMap::from([
        (
            "GET /weather".to_string(),
            RoutePaymentConfig {
                accepts: vec![basic.to_accept_config()],   // Basic only
                description: "Weather data (Basic plan)".into(),
                mime_type: "application/json".into(),
                sync_settle: Some(true),
                resource: None,
                operation: None,
            },
        ),
        (
            "GET /premium".to_string(),
            RoutePaymentConfig {
                accepts: vec![pro.to_accept_config()],      // Pro only; Basic sub -> 402
                description: "Premium analytics (Pro plan only)".into(),
                mime_type: "application/json".into(),
                sync_settle: Some(true),
                resource: None,
                operation: None,
            },
        ),
    ]);

    // Attach subscription support -> middleware auto-handles create + APP-Access gating.
    let app = Router::new()
        .route("/weather", get(weather_handler))
        .route("/premium", get(weather_handler))
        .layer(
            PaymentMiddlewareBuilder::new(routes, server)
                .subscription(subscription)
                .build(),
        );

    let listener = tokio::net::TcpListener::bind("0.0.0.0:4022").await.unwrap();
    axum::serve(listener, app).await.unwrap();
}

async fn weather_handler() -> Json<Value> {
    Json(json!({ "report": { "weather": "sunny", "temperature": 23 } }))
}
```

--------------------------------

### Example Initialization of OKXUniversalConnectUI

Source: https://web3.okx.com/onchainos/dev-docs/wallet/dapp-connect/app-connect-aptos-ui

A complete example showing how to initialize the OKXUniversalConnectUI with metadata, action configurations, language, and theme preferences.

```typescript
import { OKXUniversalConnectUI } from "@okxconnect/ui";

const okxUniversalConnectUI = await OKXUniversalConnectUI.init({
    dappMetaData: {
        icon: "https://static.okx.com/cdn/assets/imgs/247/58E63FEA47A2B7D7.png",
        name: "OKX Connect Demo"
    },
    actionsConfiguration: {
        returnStrategy: 'tg://resolve',
        modals:"all"
    },
    language: "en_US",
    uiPreferences: {
        theme: THEME.LIGHT
    },
});
```

--------------------------------

### Get Token Holder List Request

Source: https://web3.okx.com/onchainos/dev-docs/xlayer/developer/data/token-holder-list

Example cURL request to retrieve token position data using the GET method.

```shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/token/position-list?chainShortName=xlayer&tokenContractAddress=0x1e4a5963abfd975d8c9021ce480b42188849d41d&limit=1' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
```

--------------------------------

### Initialize OKXFacilitatorClient

Source: https://web3.okx.com/onchainos/dev-docs/payments/sdk-go

Example of initializing the OKXFacilitatorClient with authentication credentials and configuration settings.

```go
import x402http "github.com/okx/payments/go/x402/http"

syncSettle := true
fac, err := x402http.NewOKXFacilitatorClient(&x402http.OKXFacilitatorConfig{
	Auth: x402http.OKXAuthConfig{
		APIKey:     apiKey,
		SecretKey:  secretKey,
		Passphrase: passphrase,
		// BaseURL / BasePath optional
	},
	BaseURL:    "https://web3.okx.com", // default value; can be overridden for sandbox/staging
	SyncSettle: &syncSettle,            // default true: returns after on-chain confirmation (exact)
})
```

--------------------------------

### Get Liquidity Sources via cURL

Source: https://web3.okx.com/onchainos/dev-docs/trade/dex-get-liquidity

Example request to retrieve liquidity sources for Ethereum (chainIndex=1) using the GET method.

```shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/aggregator/get-liquidity?chainIndex=1' \

--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
```

--------------------------------

### Connect and Sign Example

Source: https://web3.okx.com/onchainos/dev-docs/wallet/dapp-connect/app-connect-aptos-ui

Example showing how to set up a listener for the 'connect_signResponse' event and invoke the openModalAndSign method with Aptos configuration.

```typescript
// Add the signature result monitor first
okxUniversalConnectUI.on("connect_signResponse", (signResponse) => {
  console.log(signResponse);
});
var session = await okxUniversalConnectUI.openModalAndSign({
        namespaces: {
            aptos: {
                chains: ["aptos:mainnet", // aptos mainnet
                 // "movement:testnet",// movement testnet
                ],
            }
        },
        sessionConfig: {
            redirect: "tg://resolve"
        }
    },
    [
        {
            chainId: "aptos:mainnet",
            method: "aptos_signMessage",
            params: {
                address: true,
                application: true,
                chainId: true,
                message: "Hello Aptos",
                nonce: "1234"
            }
        }
])
```

--------------------------------

### Get Latest DEX Trades Request

Source: https://web3.okx.com/onchainos/dev-docs/market/market-portfolio-address-tracker-trades

Example request to retrieve trades for smart money addresses using the GET method.

```shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/address-tracker/trades?trackerType=1' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
```

--------------------------------

### Example Usage with Fees

Source: https://web3.okx.com/onchainos/dev-docs/trade/dex-api-addfee

JavaScript example showing how to get a swap quote with fee parameters and make a request to the /api/v6/dex/aggregator/swap endpoint.

```APIDOC
## Example Usage with Fees

### Description
JavaScript example showing how to get a swap quote with fee parameters and make a request to the /api/v6/dex/aggregator/swap endpoint.

### Code
```json
    // .. Previous code implementation
    // Get swap quote
    const quoteParams = {
        chainIndex: SOLANA_CHAIN_ID,
        amount: rawAmount,
        fromTokenAddress,
        toTokenAddress,
        slippagePercent: "0.5", // 0.5% slippagePercent
        userWalletAddress: userAddress,

        // Additional Fee params
        fromTokenReferrerWalletAddress: "fee-recipient-wallet-address",
        feePercent: "1",

        // The wallet addresses to receive the referrer fee (Each transaction can only choose referrer fee from either the fromToken or the toToken)
        // toTokenReferrerWalletAddress: "Fee receiving address,
        // fromTokenReferrerWalletAddress: "Fee receiving address",

    } as Record<string, string>;

    const timestamp = new Date().toISOString();
    const requestPath = "/api/v6/dex/aggregator/swap";
    const queryString = "?" + new URLSearchParams(quoteParams).toString();
    const headers = getHeaders(timestamp, "GET", requestPath, queryString);

    const response = await fetch(
        `https://web3.okx.com${requestPath}${queryString}`,
        { method: "GET", headers }
    );

    const data = await response.json();

    // .. Continue code implementation
```
```

--------------------------------

### End-to-end assembly example

Source: https://web3.okx.com/onchainos/dev-docs/payments/sdk-go

Demonstrates initializing the payment gate with adapters and mounting it to an http.ServeMux. The gate is used as middleware for specific routes.

```go
package main

import (
    "net/http"

    mppadapters "github.com/okx/payments/go/mpp/adapters"
    "github.com/okx/payments/go/mpp/server"
    pr "github.com/okx/payments/go/paymentrouter"
    prhttp "github.com/okx/payments/go/paymentrouter/nethttp"
    x402adapters "github.com/okx/payments/go/x402/adapters"
    x402http "github.com/okx/payments/go/x402/http"
)

func main() {
    // mpp *server.Mpp and x402Server *x402http.HTTPServer are constructed per their respective references (omitted).
    var mpp *server.Mpp
    var x402Server *x402http.HTTPServer

    gate := prhttp.New(
        []pr.ProtocolAdapter{
            mppadapters.NewMppAdapter(mpp),
            x402adapters.NewX402Adapter(x402Server),
        },
        prhttp.WithOnError(func(err error, phase, protocol string) {
            // log protocol errors at each of the detect / challenge / handle phases
        }),
    )

    routeCfg := pr.RouteConfig{
        "mpp": mppadapters.MppRouteConfig{
            Intent:   "charge",
            Amount:   "100",
            Currency: "0x...",
            Decimals: 6,
            Description: "photo",
        },
        "x402": x402http.RouteConfig{
            Description: "photo",
            MimeType:    "image/png",
            // Accepts: ... see the x402 reference
        },
    }

    mux := http.NewServeMux()
    mux.Handle("GET /photo", gate.For(routeCfg)(photoHandler()))
    http.ListenAndServe(":8080", mux)
}

func photoHandler() http.Handler { /* protocol-agnostic business handler */ return nil }
```

--------------------------------

### Connect to Wallet Example

Source: https://web3.okx.com/onchainos/dev-docs/wallet/dapp-connect/app-connect-solana-sdk

Example of connecting to the wallet with specified Solana namespaces and redirect configuration.

```typescript
var session = await okxUniversalProvider.connect({
    namespaces: {
        solana: {
            chains: ["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", // solana mainnet
            //  "sonic:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",// sonic mainnet
            //  "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z",// solana testnet
            //  "sonic:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z",// sonic testnet ；
            ],
        }
    },
    sessionConfig: {
        redirect: "tg://resolve"
    }
})
```

--------------------------------

### SignTransaction Example

Source: https://web3.okx.com/onchainos/dev-docs/wallet/dapp-connect/app-connect-tron-sdk

An example demonstrating how to initialize TronWeb, get an account address, build a transaction, and sign it using the OKX Tron provider.

```ts
let tronWeb = new TronWeb({
    "fullHost": 'https://api.trongrid.io',
    "headers": {},
    "privateKey": ''
})
let address = okxTronProvider.getAccount("tron:mainnet").address
const transaction = await tronWeb.transactionBuilder.sendTrx("TGBcVLMnVtvJzjPWZpPiYBgwwb7th1w3BF", 1000, address);
let res = await okxTronProvider.signTransaction(transaction,"tron:mainnet")

/**Return results
 {
 "visible": true,
 "txID": "cf93bbfb0152d832fcdb1c65cb12a979eab5a631de1b3d7d6437757e1b16ed40",
 "raw_data": {
 "contract": [{
 "parameter": {
 "type_url": "type.googleapis.com/protocol.TransferContract",
 "value": {
 "amount": 1000,
 "contract_address": "",
 "owner_address": "THyDJCGXYnwCSYNQeGYW98pptEVSHwaYx7",
 "to_address": "TGBcVLMnVtvJzjPWZpPiYBgwwb7th1w3BF"
 }
 },
 "type": "TransferContract"
 }],
 "expiration": 1732073850000,
 "ref_block_bytes": "7ecf",
 "ref_block_hash": "7b3a6bc87d9edb9e",
 "timestamp": 1732073790000
 },
 "raw_data_hex": "0a027ecf22087b3a6bc87d9edb9e40908996bdb4325a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a154157c140be01fa2bbabf7f055ab879d0c05725293c12154144295a45f811a9d595562562a2e27685291a715818e80770b0b492bdb432",
 "signature": ["239b402a7605199c6969f6f4da37a355452bd942c222adfc625721d18a1fff3223f92c1d8eaf5856c0e41ce80761fd2adb80d026276d6710ad183a713af7a78d00"]
 }
 */
```

--------------------------------

### Go SDK Installation

Source: https://web3.okx.com/onchainos/dev-docs/payments/pay-as-you-go

Command to install the Go SDK for handling metered sessions.

```bash
go get github.com/okx/payments/go/mpp
```

--------------------------------

### GET /api/v6/pay/x402/supported Request Example

Source: https://web3.okx.com/onchainos/dev-docs/payments/api-http-onetime

Example cURL request to query supported schemes, networks, and signers. Requires API authentication headers.

```bash
curl --location --request GET 'https://web3.okx.com/api/v6/pay/x402/supported' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2026-04-01T12:21:41.274Z'
```

--------------------------------

### GET /social/news/latest Request Example

Source: https://web3.okx.com/onchainos/dev-docs/market/market-social-news-latest

A cURL request example to retrieve the latest social news with specified limit, detail level, and language parameters.

```shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/social/news/latest?limit=10&detailLevel=1&language=en_US' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
```

--------------------------------

### Install Onchain OS and log in

Source: https://web3.okx.com/onchainos/dev-docs/okxai/registerasp

Command to install Onchain OS and initiate the login process via Agentic Wallet.

```text
Install Onchain OS via npx -y @okxweb3/onchainos-installer install , then log in to Agentic Wallet with my email
```

--------------------------------

### Constructing x402HTTPResourceServer

Source: https://web3.okx.com/onchainos/dev-docs/payments/sdk-python

Demonstrates how to initialize the resource server and register payment schemes.

```python
from x402.server import x402ResourceServer
from x402.http import x402HTTPResourceServer

resource = x402ResourceServer(facilitator)
resource.register("eip155:196", ExactEvmScheme())
resource.register("eip155:196", AggrDeferredEvmScheme())
http_server = x402HTTPResourceServer(resource, routes={})
x402_adapter = X402Adapter(http_server)
```

--------------------------------

### HMAC SHA256 Signature Generation Example

Source: https://web3.okx.com/onchainos/dev-docs/home/api-access-and-usage

Example of generating a signature using CryptoJS for a GET request. The timestamp must match the OK-ACCESS-TIMESTAMP header.

```javascript
sign=CryptoJS.enc.Base64.stringify(CryptoJS.HmacSHA256(timestamp + 'GET' + '/api/v6/dex/aggregator/swap', SecretKey))
```

--------------------------------

### server.initialize()

Source: https://web3.okx.com/onchainos/dev-docs/payments/sdk-nodejs

Fetches supported kinds from the facilitator. Should be called once at startup.

```APIDOC
## server.initialize()

### Description
Fetches supported kinds from the facilitator. Should be called once at startup.

### Method
initialize()

### Example
```typescript
await server.initialize();
```
```

--------------------------------

### Get swap quote

Source: https://web3.okx.com/onchainos/dev-docs/trade/dex-ai-tools-skills

Example interaction to fetch a quote for a token swap.

```shell
How much USDC will I get for 1 OKB on X-layer?
# Call dex-quote
```

--------------------------------

### Get Bitcoin accounts with okxwallet.bitcoin.getAccounts()

Source: https://web3.okx.com/onchainos/dev-docs/wallet/dapp-connect/chains/bitcoin/provider

Gets the address of the current account. Available for extension version 2.77.1 or above. The example includes a try/catch block and shows the expected result.

```typescript
try {
  let res = await okxwallet.bitcoin.getAccounts();
  console.log(res);
} catch (e) {
  console.log(e);
}
// example
['tb1qrn7tvhdf6wnh790384ahj56u0xaa0kqgautnnz'];
```

--------------------------------

### End-to-end assembly example

Source: https://web3.okx.com/onchainos/dev-docs/payments/sdk-go

Complete example showing how to construct a PaymentGate with MPP and x402 adapters, define a route config, and mount it onto a net/http ServeMux.

```APIDOC
## End-to-end assembly example

### Description

This example demonstrates how to assemble a payment router with MPP and x402 adapters, configure a route, and mount it onto a net/http ServeMux.

### Code

```go
package main

import (
    "net/http"

    mppadapters "github.com/okx/payments/go/mpp/adapters"
    "github.com/okx/payments/go/mpp/server"
    pr "github.com/okx/payments/go/paymentrouter"
    prhttp "github.com/okx/payments/go/paymentrouter/nethttp"
    x402adapters "github.com/okx/payments/go/x402/adapters"
    x402http "github.com/okx/payments/go/x402/http"
)

func main() {
    // mpp *server.Mpp and x402Server *x402http.HTTPServer are constructed per their respective references (omitted).
    var mpp *server.Mpp
    var x402Server *x402http.HTTPServer

    gate := prhttp.New(
        []pr.ProtocolAdapter{
            mppadapters.NewMppAdapter(mpp),
            x402adapters.NewX402Adapter(x402Server),
        },
        prhttp.WithOnError(func(err error, phase, protocol string) {
            // log protocol errors at each of the detect / challenge / handle phases
        }),
    )

    routeCfg := pr.RouteConfig{
        "mpp": mppadapters.MppRouteConfig{
            Intent:   "charge",
            Amount:   "100",
            Currency: "0x...",
            Decimals: 6,
            Description: "photo",
        },
        "x402": x402http.RouteConfig{
            Description: "photo",
            MimeType:    "image/png",
            // Accepts: ... see the x402 reference
        },
    }

    mux := http.NewServeMux()
    mux.Handle("GET /photo", gate.For(routeCfg)(photoHandler()))
    http.ListenAndServe(":8080", mux)
}

func photoHandler() http.Handler { /* protocol-agnostic business handler */ return nil }
```
```

--------------------------------

### Batch Get Block Transactions Request

Source: https://web3.okx.com/onchainos/dev-docs/xlayer/developer/data/batch-get-block-transactions

Example of a GET request to the transaction-list-multi endpoint using cURL. It includes required authentication headers such as OK-ACCESS-KEY, OK-ACCESS-SIGN, OK-ACCESS-PASSPHRASE, and OK-ACCESS-TIMESTAMP.

```shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/block/transaction-list-multi?chainShortName=xlayer&startBlockHeight=31118669&endBlockHeight=31118670&limit=1' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
```
Tokens:
Raw