From 0aef7450f555501bf484f15ccd5b1b830285b2c2 Mon Sep 17 00:00:00 2001
From: Vasco Santos <santos.vasco10@gmail.com>
Date: Thu, 18 Jan 2024 12:42:19 +0100
Subject: [PATCH 1/3] docs: add w3 plan basic spec

---
 w3-plan.md | 121 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 w3-plan.md

diff --git a/w3-plan.md b/w3-plan.md
new file mode 100644
index 0000000..419587c
--- /dev/null
+++ b/w3-plan.md
@@ -0,0 +1,121 @@
+# Space
+
+![status:reliable](https://img.shields.io/badge/status-reliable-green.svg?style=flat-square)
+
+## Editors
+
+- [Vasco Santos], [Protocol Labs]
+
+## Authors
+
+- [Vasco Santos], [Protocol Labs]
+
+## Abstract
+
+A Plan
+
+- [Capabilities](#capabilities)
+  - [`plan/get`](#planget)
+  - [`plan/set`](#planset)
+
+## Language
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119](https://datatracker.ietf.org/doc/html/rfc2119).
+
+## Capabilities
+
+### `plan/get`
+
+Capability can be invoked to get information about the plan that the account is currently signed up for.
+
+> `did:mailto:web.mail:alice` invokes `plan/get` capability provided by `did:web:web3.storage`
+
+```json
+{
+  "iss": "did:mailto:web.mail:alice",
+  "aud": "did:web:web3.storage",
+  "att": [
+    {
+      "with": "did:mailto:web.mail:alice",
+      "can": "plan/get"
+    }
+  ],
+  "prf": [],
+  "sig": "..."
+}
+```
+
+#### Plan Get Failure
+
+```json
+{
+  "ran": "bafy...planGet",
+  "out": {
+    "error": {
+      "name": "PlanNotFound"
+    }
+  }
+}
+```
+
+#### Plan Get Success
+
+```json
+{
+  "ran": "bafy...planGet",
+  "out": {
+    "ok": {
+      "product": "did:web:starter.web3.storage",
+      "updatedAt": "2024-01-05T06:56:26.074Z"
+    }
+  }
+}
+```
+
+### `plan/set`
+
+Capability can be invoked to change a billing plan of an account.
+
+> `did:mailto:web.mail:alice` invokes `plan/set` capability provided by `did:web:web3.storage`
+
+```json
+{
+  "iss": "did:mailto:web.mail:alice",
+  "aud": "did:web:web3.storage",
+  "att": [
+    {
+      "with": "did:mailto:web.mail:alice",
+      "can": "plan/set",
+      "nb": {
+        "product": "did:web:starter.web3.storage"
+      }
+    }
+  ],
+  "prf": [],
+  "sig": "..."
+}
+```
+
+#### Plan Set Failure
+
+```json
+{
+  "ran": "bafy...planSet",
+  "out": {
+    "error": {
+      "name": "AccountNotFound"
+    }
+  }
+}
+```
+
+#### Plan Set Success
+
+```json
+{
+  "ran": "bafy...planSet",
+  "out": {
+    "ok": {}
+  }
+}
+```

From e857ea85785a4d922ff0583ec3cac598519c895d Mon Sep 17 00:00:00 2001
From: Vasco Santos <santos.vasco10@gmail.com>
Date: Thu, 18 Jan 2024 15:43:20 +0100
Subject: [PATCH 2/3] fix: abstract

---
 w3-plan.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/w3-plan.md b/w3-plan.md
index 419587c..94bb0a3 100644
--- a/w3-plan.md
+++ b/w3-plan.md
@@ -12,7 +12,7 @@
 
 ## Abstract
 
-A Plan
+A Plan that accounts can register to, in order to have an associated billing plan for their spaces.
 
 - [Capabilities](#capabilities)
   - [`plan/get`](#planget)

From b9684b901fe159b8c3704296cdbfbc563abb112a Mon Sep 17 00:00:00 2001
From: Vasco Santos <santos.vasco10@gmail.com>
Date: Fri, 19 Jan 2024 14:20:46 +0100
Subject: [PATCH 3/3] chore: apply suggestion

Co-authored-by: Alan Shaw <alan.shaw@protocol.ai>
---
 w3-plan.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/w3-plan.md b/w3-plan.md
index 94bb0a3..8d0cb43 100644
--- a/w3-plan.md
+++ b/w3-plan.md
@@ -12,7 +12,7 @@
 
 ## Abstract
 
-A Plan that accounts can register to, in order to have an associated billing plan for their spaces.
+A plan specifies limits and restrictions on usage. Different plans have different limits and different price points. Accounts select a plan so that they can be billed the correct amount each period.
 
 - [Capabilities](#capabilities)
   - [`plan/get`](#planget)