From 91be1236f99fc4cbe69465533a83df934af34653 Mon Sep 17 00:00:00 2001
From: ryanchristo <12519942+ryanchristo@users.noreply.github.com>
Date: Thu, 12 Jan 2023 12:43:50 -0800
Subject: [PATCH] docs: add RFC for forward contract functionality

---
 specs/rfcs/003-forward-contract/README.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/specs/rfcs/003-forward-contract/README.md b/specs/rfcs/003-forward-contract/README.md
index aa31e4d880..07c2ee4ecc 100644
--- a/specs/rfcs/003-forward-contract/README.md
+++ b/specs/rfcs/003-forward-contract/README.md
@@ -316,6 +316,8 @@ message Contract {
 ### Contract Reserve State
 
 ```protobuf
+// ContractReserve defines a forward contract reserve (aka "buffer pool")
+// and the table within which forward contract reserves are stored.
 message ContractReserve {
   option (cosmos.orm.v1alpha1.table) = {
     id : 2,
@@ -326,9 +328,10 @@ message ContractReserve {
   uint64 contract_id = 1;
 
   // balances is the list of credit batch balances held in the reserve.
-  repeated Balances balances = 2;
+  repeated Balance balances = 2;
 
-  message Balances {
+  // Balance defines a balance of credits held in the reserve.
+  message Balance {
 
     // batch_denom is the amount of tradable credits in the reserve.
     string batch_denom = 1;