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 fixedsubscriptionRateeach interval (escrow funded by the owner).EventDrivenwith fixed per-job rates: the job submitter pays a fixed amount atsubmitJob(), 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 usingcreateServiceFromQuotes(...).- 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-enginegRPC server) - your on-chain operator preferences updated with that endpoint
If your quote server address changes, update it on-chain via updateOperatorPreferences (see ITangleOperators).
Running the Pricing Engine (Recommended)
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