Capability on post is a list

README.md

@@ -102,7 +102,7 @@ Follow Accept from **Bob** to **Alice** with attached capabilities.
  'type': 'Accept'}
 ```
 
-When posts are subsequently sent from the following instance (server-to-server) they should have the corresponding capability id string attached within the Create wrapper. In the above example that would be **http://bobdomain.net/caps/rOYtHApyr4ZWDUgEE1KqjhTe0kI3T2wJ**. It should contain a random string which is hard to guess by brute force methods.
+When posts are subsequently sent from the following instance (server-to-server) they should have the corresponding capability id string attached within the Create wrapper. To handle the *shared inbox* scenario this should be a list rather than a single string. In the above example that would be *['http://bobdomain.net/caps/rOYtHApyr4ZWDUgEE1KqjhTe0kI3T2wJ']*. It should contain a random string which is hard to guess by brute force methods.
 
 ``` text
                             Alice
@@ -141,6 +141,12 @@ Subsequently **Bob** could change the stored capabilities for **Alice** in their
 
 Object capabilities can be strictly enforced by adding the **--ocap** option when running the server. The only activities which it is not enforced upon are **Follow** and **Accept**. Anyone can create a follow request or accept updated capabilities.
 
+## Object capabilities in the shared inbox scenario
+
+Shared inboxes are obviously essential for any kind of scalability, otherwise there would be vast amounts of duplicated messages being dumped onto the intertubes like a big truck.
+
+With the shared inbox instead of sending from Alice to 500 of her fans on a different instance - repeatedly sending the same message to individual inboxes - a single message is sent to its shared inbox (which has its own special account called 'inbox') and it then decides how to distribute that. If a list of capability ids is attached to the message which gets sent to the shared inbox then the receiving server can use that.
+
 ## Some capabilities
 
 *inbox:write* - follower can post anything to your inbox

daemon.py

@@ -491,7 +491,7 @@ class PubServer(BaseHTTPRequestHandler):
         else:
             if self.path == '/sharedInbox' or self.path == '/inbox':
                 print('DEBUG: POST to shared inbox')
-                if self._updateInboxQueue('sharedinbox',messageJson):
+                if self._updateInboxQueue('inbox',messageJson):
                     return
         self.send_response(200)
         self.end_headers()

epicyon.py

@@ -332,9 +332,9 @@ if not os.path.isdir(baseDir+'/accounts/'+nickname+'@'+domain):
     setConfigParam(baseDir,'adminPassword',adminPassword)
     createPerson(baseDir,nickname,domain,port,httpPrefix,True,adminPassword)
 
-if not os.path.isdir(baseDir+'/accounts/sharedinbox@'+domain):
+if not os.path.isdir(baseDir+'/accounts/inbox@'+domain):
-    print('Creating shared inbox')
+    print('Creating shared inbox: inbox@'+domain)
-    createSharedInbox(baseDir,'sharedinbox',domain,port,httpPrefix)
+    createSharedInbox(baseDir,'inbox',domain,port,httpPrefix)
 
 if not os.path.isdir(baseDir+'/accounts/capabilities@'+domain):
     print('Creating capabilities account which can sign requests')

follow.py

@@ -33,7 +33,7 @@ def getFollowersOfPerson(baseDir: str, \
     for subdir, dirs, files in os.walk(baseDir+'/accounts'):
         for account in dirs:
             filename = os.path.join(subdir, account)+'/'+followFile
-            if account == handle or account.startswith('sharedinbox@'):
+            if account == handle or account.startswith('inbox@'):
                 continue
             if not os.path.isfile(filename):
                 continue

inbox.py

@@ -124,7 +124,7 @@ def savePostToInboxQueue(baseDir: str,httpPrefix: str,nickname: str, domain: str
     filename=inboxQueueDir+'/'+postId.replace('/','#')+'.json'
 
     sharedInboxItem=False
-    if nickname=='sharedinbox':
+    if nickname=='inbox':
         sharedInboxItem=True
         
     newQueueItem = {
@@ -179,15 +179,29 @@ def runInboxQueue(baseDir: str,httpPrefix: str,sendThreads: [],postLog: [],cache
             with open(queueFilename, 'r') as fp:
                 queueJson=commentjson.load(fp)
 
+            sentToSharedInbox=False
+            if queueJson['post'].get('actor'):
+                if queueJson['post']['actor'].endswith('/inbox'):
+                    sentToSharedInbox=True
+
+            if sentToSharedInbox:
+                # if this is arriving at the shared inbox then
+                # don't do the capabilities checks
+                capabilitiesPassed=True
+                # TODO how to handle capabilities in the shared inbox scenario?
+                # should 'capability' be a list instead of a single value?
+            else:
                 # check that capabilities are accepted            
                 capabilitiesPassed=False
                 if queueJson['post'].get('capability'):
-                if isinstance(queueJson['post']['capability'], dict):
+                    if not isinstance(queueJson['post']['capability'], list):
                         if debug:
-                        print('DEBUG: capability is a dictionary when it should be a string')
+                            print('DEBUG: capability on post should be a list')
                         os.remove(queueFilename)
                         queue.pop(0)
                         continue
+                    capabilityIdList=queueJson['post']['capability']
+                    
                     ocapFilename= \
                         getOcapFilename(baseDir, \
                                         queueJson['nickname'],queueJson['domain'], \
@@ -207,7 +221,7 @@ def runInboxQueue(baseDir: str,httpPrefix: str,sendThreads: [],postLog: [],cache
                             os.remove(queueFilename)
                             queue.pop(0)
                             continue
-                    if oc['id']!=queueJson['post']['capability']:
+                        if oc['id']!=capabilityIdList[0]:
                             if debug:
                                 print('DEBUG: capability id mismatch')
                             os.remove(queueFilename)
@@ -347,7 +361,7 @@ def runInboxQueue(baseDir: str,httpPrefix: str,sendThreads: [],postLog: [],cache
                                     # post already exists in this person's inbox
                                     continue
                                 # We could do this in a more storage space efficient way
-                                # by linking to the inbox of sharedinbox@domain
+                                # by linking to the inbox of inbox@domain
                                 # However, this allows for easy deletion by individuals
                                 # without affecting any other people
                                 copyfile(queueFilename, destination)

person.py

@@ -140,7 +140,7 @@ def validNickname(nickname: str) -> bool:
     for c in forbiddenChars:
         if c in nickname:
             return False
-    reservedNames=['inbox','outbox','following','followers','sharedinbox','capabilities']
+    reservedNames=['inbox','outbox','following','followers','capabilities']
     if nickname in reservedNames:
         return False
     return True

posts.py

@@ -351,19 +351,17 @@ def createPostBase(baseDir: str,nickname: str, domain: str, port: int, \
         # if capabilities have been granted for this actor
         # then get the corresponding id
         capabilityId=None
+        capabilityIdList=[]
         ocapFilename=getOcapFilename(baseDir,nickname,domain,toUrl,'granted')
-        #print('ocapFilename: '+ocapFilename)
         if os.path.isfile(ocapFilename):
             with open(ocapFilename, 'r') as fp:
                 oc=commentjson.load(fp)
                 if oc.get('id'):
-                    capabilityId=oc['id']
+                    capabilityIdList=[oc['id']]
-        #else:
-        #    print('ocapFilename: '+ocapFilename+' not found')
 
         newPost = {
             'id': newPostId+'/activity',
-            'capability': capabilityId,
+            'capability': capabilityIdList,
             'type': 'Create',
             'actor': actorUrl,
             'published': published,
@@ -464,6 +462,32 @@ def outboxMessageCreateWrap(httpPrefix: str,nickname: str,domain: str, \
         httpPrefix+'://'+domain+'/users/'+nickname+'/statuses/'+statusNumber
     return newPost
 
+def postIsAddressedToFollowers(baseDir: str,
+                               nickname: str, domain: str, port: int,httpPrefix: str,
+                               postJson: {}) -> bool:
+    """Returns true if the given post is addressed to followers of the nickname
+    """
+    if port!=80 and port!=443:
+        domain=domain+':'+str(port)
+
+    if not postJson.get('object'):
+        return False
+    if not postJson['object'].get('to'):
+        return False
+        
+    followersUrl=httpPrefix+'://'+domain+'/users/'+nickname+'/followers'
+
+    # does the followers url exist in 'to' or 'cc' lists?
+    addressedToFollowers=False
+    if followersUrl in postJson['object']['to']:
+        addressedToFollowers=True
+    if not addressedToFollowers:
+        if not postJson['object'].get('cc'):
+            return False
+        if followersUrl in postJson['object']['cc']:
+            addressedToFollowers=True
+    return addressedToFollowers
+
 def createPublicPost(baseDir: str,
                      nickname: str, domain: str, port: int,httpPrefix: str, \
                      content: str, followersOnly: bool, saveToFile: bool,
@@ -626,6 +650,10 @@ def sendSignedJson(postJsonObject: {},session,baseDir: str, \
     """
     withDigest=True
 
+    sharedInbox=False
+    if toNickname=='inbox':
+        sharedInbox=True
+    
     if toPort!=80 and toPort!=443:
         if ':' not in toDomain:
             toDomain=toDomain+':'+str(toPort)        
@@ -645,18 +673,16 @@ def sendSignedJson(postJsonObject: {},session,baseDir: str, \
         postToBox='outbox'
     
     # get the actor inbox/outbox/capabilities for the To handle
-    inboxUrl,pubKeyId,pubKey,toPersonId,sharedInbox,capabilityAcquisition = \
+    inboxUrl,pubKeyId,pubKey,toPersonId,sharedInboxUrl,capabilityAcquisition = \
         getPersonBox(session,wfRequest,personCache,postToBox)
 
-    # If there are more than one followers on the target domain
-    # then send to teh shared inbox indead of the individual inbox
     if nickname=='capabilities':
         inboxUrl=capabilityAcquisition
         if not capabilityAcquisition:
             return 2
     else:
-        if noOfFollowersOnDomain(baseDir,handle,toDomain)>1 and sharedInbox:        
+        if sharedInbox and sharedInboxUrl:        
-            inboxUrl=sharedInbox
+            inboxUrl=sharedInboxUrl
 
     if debug:
         print('DEBUG: Sending to endpoint '+inboxUrl)
@@ -702,6 +728,40 @@ def sendSignedJson(postJsonObject: {},session,baseDir: str, \
     thr.start()
     return 0
 
+def sendToFollowers(session,baseDir: str,
+                    nickname: str, domain: str, port: int,httpPrefix: str,
+                    postJsonObject: {}):
+    """sends a post to the followers of the given nickname
+    """
+    if not postIsAddressedToFollowers(baseDir,nickname,domain, \
+                                      port,httpPrefix,postJsonObject):
+        return
+
+    grouped=groupFollowersByDomain(baseDir,nickname,domain)
+    if not grouped:
+        return
+
+    # for each instance
+    for followerDomain,followerHandles in grouped.items():
+        toPort=port
+        index=0
+        toDomain=followerHandles[index].split('@')[1]
+        if ':' in toDomain:
+            toPort=toDomain.split(':')[1]
+            toDomain=toDomain.split(':')[0]
+        toNickname=followerHandles[index].split('@')[0]
+        cc=''
+        if len(followerHandles)>1:
+            nickname='inbox'
+            toNickname='inbox'
+        sendSignedJson(postJsonObject,session,baseDir, \
+                       nickname,domain,port, \
+                       toNickname,toDomain,toPort, \
+                       cc,httpPrefix,True,clientToServer, \
+                       federationList,ocapGranted, \
+                       sendThreads,postLog,cachedWebfingers, \
+                       personCache,debug)
+
 def createInbox(baseDir: str,nickname: str,domain: str,port: int,httpPrefix: str, \
                  itemsPerPage: int,headerOnly: bool,pageNumber=None) -> {}:
     return createBoxBase(baseDir,'inbox',nickname,domain,port,httpPrefix, \