在 OpenFiat 之上开发

# From a clone of openfiat-core. The package is openfiat-cli;
# the binary it produces is openfiat-node.
cargo run -p openfiat-cli -- --rpc-bind-address 127.0.0.1:7080

# In another shell:
curl -s http://localhost:7080/health
# ok

# Every method this node serves, straight from its own method table.
curl -s http://localhost:7080/openrpc.json | jq '.methods[].name'

# The same document, rendered as an interactive reference you can
# call methods from — browse to:
#   http://localhost:7080/docs

[dependencies]
openfiat-sdk = { git = "https://github.com/OpenFiat-org/openfiat-sdks", rev = "<commit>", package = "openfiat-sdk" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

{
  "dependencies": {
    "@openfiat/sdk": "github:OpenFiat-org/openfiat-sdks#<commit>&path:typescript"
  }
}

git clone https://github.com/OpenFiat-org/openfiat-sdks
cd openfiat-sdks

# Rust: registers a service provider and publishes a signed rate.
(cd rust && cargo run --example oracle_provider)

# TypeScript: the same example, same default endpoint.
(cd typescript && pnpm install && pnpm tsx examples/oracle_provider.ts)

use openfiat_sdk::{Client, ClientConfig};

// The base URL — the SDK appends /rpc itself.
let client = Client::new(ClientConfig {
    endpoint: "http://localhost:7080".to_string(),
    ..ClientConfig::default()
});

println!("node version: {}", client.get_version().await?);

let ads = client.get_advertisements().await?;
println!("{} advertisements on this node", ads.len());

import { Client, advertisements, node } from "@openfiat/sdk";

const client = new Client({ endpoint: "http://localhost:7080", timeoutMs: 30_000 });

console.log("node version:", await node.getVersion(client));

const ads = await advertisements.getAdvertisements(client);
console.log(ads.length, "advertisements on this node");

use openfiat_sdk::wallet::{keypair_from_wallet, solana_keyfile};

// Solana CLI wallet.json format — the same file the node itself uses.
let wallet = solana_keyfile::load("/etc/openfiat/wallet.json")?;
let keypair = keypair_from_wallet(&wallet);

// Every send_* takes the domain's unsigned event plus your keypair.
// See the merchant guide for how to fill in an AdvertisementCreate.
let id = client.send_advertisement_create(create, &keypair).await?;

import { advertisements } from "@openfiat/sdk";
// File I/O lives in a separate entry point, so the main one stays
// browser- and edge-safe.
import { loadWalletFile } from "@openfiat/sdk/node";

const wallet = await loadWalletFile("/etc/openfiat/wallet.json");

const id = await advertisements.sendAdvertisementCreate(client, create, wallet.keypair);

use openfiat_sdk::onchain::{Role, staking};

// Returns a plain solana_instruction::Instruction — nothing is signed
// or submitted here.
let ix = staking::stake_ix(&owner, Role::Arbitrator, &mint, &from, amount);

// Build a transaction with this blockhash, sign it yourself, then relay:
let blockhash = client.get_latest_blockhash().await?.blockhash;
client.send_transaction(&signed_tx).await?;

# Deployed to devnet only — there is no mainnet deployment.
escrow      HaPpM1QYM3dKp3sX7zhEdft9hB6ncu6xfALAbkyQChQP
staking     HYEXk8XQukBkZbiYB33JyVefQDxqyCpPudad3wBCyYmx
governance  AVJfKUjHsizkGGUy8sdz4Xma2hVgmgvgg8GmUMs8E4eE

// getDisputes has no typed wrapper in the TypeScript SDK yet.
// call() reaches any method the node serves; you supply the types.
const disputes = await client.call<Record<string, never>, unknown[]>(
  "getDisputes",
  {},
);