OperatePricingPricing Basics

Blueprint Pricing

SDK source (GitHub): https://github.com/tangle-network/blueprint/tree/main/crates/pricing-engine

Operator preferences interface (GitHub): https://github.com/tangle-network/tnt-core/blob/main/src/interfaces/ITangleOperators.sol

As an operator, you get paid based on how a blueprint is configured to charge. Some pricing is fixed on-chain (no quote service required). Other flows require operators to serve signed quotes off-chain (RFQ).

Prerequisites

  • Basic understanding of Tangle Network operations
  • Familiarity with the Blueprint Manager runtime
  • Knowledge of blueprint service lifecycles

Pricing Models (What You Need to Run)

Every blueprint declares a pricing model at registration time. As an operator, your responsibilities depend on the model.

Reference: /developers/blueprints/pricing-and-payments

Fixed On-Chain Pricing (No RFQ)

In most deployments these flows do not require you to run a quote server:

  • Subscription: the service is billed on-chain at a fixed subscriptionRate each interval (escrow funded by the owner).
  • EventDriven with fixed per-job rates: the job submitter pays a fixed amount at submitJob(), resolved from the blueprint config and optional per-job overrides.

In these models, you still need normal operational hygiene (uptime, heartbeats, QoS, and correct consumer behavior), but you do not need to publish off-chain quotes to get paid.

RFQ Pricing (You Must Serve Quotes)

These flows require operators to generate and sign EIP-712 quotes off-chain:

  • PayOnce: users create a service using createServiceFromQuotes(...).
  • Job RFQ: users submit jobs using submitJobFromQuote(...).

If the customer requests a specific confidentiality mode for the service, that confidentiality intent is part of the service RFQ agreement and should be reflected in your quote and operating cost assumptions.

To participate in RFQ, you need:

  • a quote serving endpoint (typically the pricing-engine gRPC server)
  • your on-chain operator preferences updated with that endpoint

If your quote server address changes, update it on-chain via updateOperatorPreferences (see ITangleOperators).

The simplest path is to run the pricing-engine-server binary and configure:

  • operator identity and quote signing key (operator.toml)
  • service quote pricing tables (resource pricing TOML)
  • job quote pricing tables (job pricing TOML)

Developer and operator details live here:

  • /developers/blueprints/pricing-engine

Optional: x402 Settlement (Paid HTTP Jobs)

If you want an HTTP-first paid job interface (stablecoin settlement on EVM chains), you can run the SDK’s x402 gateway. This is separate from on-chain payment collection and is operated as a Blueprint Runner background service.

Reference:

  • /developers/blueprint-runner/x402