docs: add w3 space basic spec #93
Conversation
vasco-santos
force-pushed
the
docs/add-w3-space
branch
from
5555e51 to
a07ad72
Compare
w3-space.md
Outdated
| } | ||
| ``` | ||
|
|
||
| ### `space/allocate` |
There was a problem hiding this comment.
Do we want to document this? AFAIK it is not used by our client/server as an invoked capability...although the handler is used by store/add handler.
However it doesn't do anything related to allocating space - it rate limits and checks for storage provider.
There was a problem hiding this comment.
it is used by store/add yes. I think it should be documented, as store/add may happen in another place in the future.
However it doesn't do anything related to allocating space - it rate limits and checks for storage provider.
I think because it is not implemented? But that is the goal here? We can make that clear in the spec if that would be the desire.
Maybe @travis can help out with decision here
There was a problem hiding this comment.
it is used by
store/addyes. I think it should be documented, asstore/addmay happen in another place in the future.
Right but I think that should be in w3-store.md and should say that store/add MAY rate limit and SHOULD ensure the space is provisioned properly.
I think because it is not implemented? But that is the goal here? We can make that clear in the spec if that would be the desire.
I would just remove it - it is not invoked and does nothing to do with allocating space. The handler function should instead be a lib/utility function.
There was a problem hiding this comment.
ok, I removed until we decide what to do
Adds basic space spec. While at first considered to add it to
w3-accountorw3-access, I realized that account has a specific focus on high level account with multiple spaces, while access focus on "aggregating and managing delegated capabilities across agents". Therefore, ended up with new spec document to reflect the basics of a space protocol.It is complemented by
w3-accountandw3-provideron how to integrate account and providers, while in its basic form adds wire protocol for the space specific capabilities that do not fall under the umbrella ofaccountandprovider.