docs: add improved sessions blog post by brendanjryan · Pull Request #695 · tempoxyz/mpp

brendanjryan · 2026-06-11T22:37:30Z

Summary

Add blog post for sessions v2

vercel · 2026-06-11T22:37:35Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
mpp	Ready	Preview, Comment	Jun 12, 2026 2:17pm

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9129695fc0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-06-11T22:43:18Z

+export async function handler(request: Request) {
+  // [!code hl:start]
+  const result = await mppx.session({
+    amount: '25',


Keep the example price within the client cap

This server example charges 25 human-readable currency units per llm_token, but the paired client example below caps maxDeposit at 1, so copying the integration cannot authorize even one metered unit and paid requests will fail instead of demonstrating improved sessions. Use a realistic sub-dollar per-token amount or raise the client cap so the example can complete.

Useful? React with 👍 / 👎.

brendanjryan · 2026-06-11T22:44:25Z

 <BlogPostList posts={[
+  {
+    date: "Friday, June 12, 2026",
+    title: "Improved sessions",


an improved sessions experience

brendanjryan · 2026-06-11T22:44:32Z

+  {
+    date: "Friday, June 12, 2026",
+    title: "Improved sessions",
+    description: <>Improved sessions make pay-as-you-go API billing cheaper and easier to integrate.</>,


same as above

brendanjryan · 2026-06-11T22:44:50Z

+
+Sessions are one of MPP's core primitives. They power the cost-efficient, high-throughput, usage-based billing that modern APIs and services depend on—metering payment at the granularity of a single LLM token, API call, or byte transferred.
+
+Today we're shipping two improvements that make sessions the cheapest and easiest machine-payments primitive to integrate:


remove hyphen

brendanjryan · 2026-06-11T22:45:09Z

+Today we're shipping two improvements that make sessions the cheapest and easiest machine-payments primitive to integrate:
+
+1. **The session intent is now a formal spec.** Sessions are standardized as an MPP intent (`session`), so extending them to new payment methods and networks is faster and more predictable.
+2. **Sessions on Tempo are faster and cheaper.** The new [TIP-1034](https://tips.sh/1034-1) precompile path cuts channel costs by as much as 72% and improves reliability.


https://tips.sh/1034

brendanjryan · 2026-06-11T22:45:20Z

+Today we're shipping two improvements that make sessions the cheapest and easiest machine-payments primitive to integrate:
+
+1. **The session intent is now a formal spec.** Sessions are standardized as an MPP intent (`session`), so extending them to new payment methods and networks is faster and more predictable.
+2. **Sessions on Tempo are faster and cheaper.** The new [TIP-1034](https://tips.sh/1034-1) precompile path cuts channel costs by as much as 72% and improves reliability.


greatly improves reliability

brendanjryan · 2026-06-11T22:46:45Z

+
+## Performance and improvements
+
+Moving the channel lifecycle onto the [TIP-1034 reserve precompile](https://tips.sh/1034-1) makes the common operations dramatically cheaper. 


makes session operations

brendanjryan · 2026-06-11T22:46:50Z

+| Open, existing reserve balance | 1,055,229 | 294,425 | -72.1% |
+| Open, first reserve balance | 1,302,429 | 791,625 | -39.2% |
+| Settle, existing payee balance | 312,037 | 301,631 | -3.3% |
+| Settle, new payee balance | 312,037 | 559,871 | +79.4% |


rm this one

brendanjryan · 2026-06-11T22:47:19Z

+
+## How to integrate
+
+On the server, use an account from the local account store, register `tempo.session`, and call `mppx.session`:


just register tempo.session.. remove the "and call"

brendanjryan · 2026-06-11T22:47:43Z

+
+- [Tempo session IETF Specification](https://paymentauth.org/draft-tempo-session-00)
+- [Sessions guide](/payment-methods/tempo/session)
+- [`tempo.session` server API](/sdk/typescript/server/Method.tempo.session)


brendanjryan · 2026-06-11T22:47:46Z

+- [Tempo session IETF Specification](https://paymentauth.org/draft-tempo-session-00)
+- [Sessions guide](/payment-methods/tempo/session)
+- [`tempo.session` server API](/sdk/typescript/server/Method.tempo.session)
+- [`tempo.session` client API](/sdk/typescript/client/Method.tempo.session)


This reverts commit 59120fb.

parvahuja · 2026-06-11T23:16:51Z

+
+A session lets a client authorize spending once, then incrementally increase the authorized amount as it consumes a service—paying exactly for what it uses. Instead of one payment per request, the client and server maintain a single running authorization that grows with usage.
+
+By keeping payment verification close to instant, sessions make metering at the granularity of a single LLM token, API call, or byte transferred practical and remove credit risk, reconciliation complexity, and complex credit-based billing workflows.


By keeping payment verification close to instant, sessions make metering at the granularity of a single LLM token, API call, or byte transferred practical and remove credit risk, reconciliation complexity, and complex ~~credit-based~~ billing workflows.

parvahuja · 2026-06-11T23:21:07Z

+| Request close | 31,752 | 30,123 | -5.1% |
+| Close after settlement | 85,118 | 62,913 | -26.1% |
+
+In addition to lower costs, the new implementation makes channel operations payment-lane traffic on Tempo. Opens, top-ups, settlements, close requests, closes, and withdrawals get the same congestion treatment as payments, so providers can settle many channels while the network is busy.


...channel operations payment-lane traffic on Tempo...

It may not be immediately clear to the reader (i.e if not super familiar with Tempo semantics) the true benefits of this being on the payment-lane. Maybe worth another sentence?

github-actions Bot added the docs label Jun 11, 2026

vercel Bot deployed to Preview June 11, 2026 22:38 View deployment

brendanjryan marked this pull request as ready for review June 11, 2026 22:39

docs: add improved sessions blog post

b84770a

brendanjryan force-pushed the brendanjryan/improved-sessions-blog branch from 9129695 to b84770a Compare June 11, 2026 22:42

chatgpt-codex-connector Bot reviewed Jun 11, 2026

View reviewed changes

vercel Bot deployed to Preview June 11, 2026 22:43 View deployment

brendanjryan commented Jun 11, 2026

View reviewed changes

ci: check generated pages

59120fb

github-actions Bot added config infra labels Jun 11, 2026

vercel Bot deployed to Preview June 11, 2026 22:50 View deployment

Revert "ci: check generated pages"

5b82772

This reverts commit 59120fb.

vercel Bot deployed to Preview June 11, 2026 22:54 View deployment

docs: address improved sessions blog feedback

57c7936

vercel Bot deployed to Preview June 11, 2026 22:56 View deployment

parvahuja reviewed Jun 11, 2026

View reviewed changes

docs: address sessions blog review comments

13c84ff

vercel Bot deployed to Preview June 12, 2026 14:17 View deployment

brendanjryan merged commit ceb0453 into main Jun 15, 2026
11 checks passed

brendanjryan deleted the brendanjryan/improved-sessions-blog branch June 15, 2026 14:01


		Sessions are one of MPP's core primitives. They power the cost-efficient, high-throughput, usage-based billing that modern APIs and services depend on—metering payment at the granularity of a single LLM token, API call, or byte transferred.

		Today we're shipping two improvements that make sessions the cheapest and easiest machine-payments primitive to integrate:


		## Performance and improvements

		Moving the channel lifecycle onto the [TIP-1034 reserve precompile](https://tips.sh/1034-1) makes the common operations dramatically cheaper.


		## How to integrate

		On the server, use an account from the local account store, register `tempo.session`, and call `mppx.session`:


		A session lets a client authorize spending once, then incrementally increase the authorized amount as it consumes a service—paying exactly for what it uses. Instead of one payment per request, the client and server maintain a single running authorization that grows with usage.

		By keeping payment verification close to instant, sessions make metering at the granularity of a single LLM token, API call, or byte transferred practical and remove credit risk, reconciliation complexity, and complex credit-based billing workflows.

Uh oh!

Conversation

brendanjryan commented Jun 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

vercel Bot commented Jun 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jun 11, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

brendanjryan commented Jun 11, 2026 •

edited

Loading

vercel Bot commented Jun 11, 2026 •

edited

Loading