Merge pull request #70 from ava-labs/recent-activity

Recent activity

Author: patrick-ogrady

README.md

@@ -22,6 +22,7 @@ Usage:
   spaces-cli [command]
 
 Available Commands:
+  activity    View recent activity on the network
   claim       Claims the given prefix
   completion  generate the autocompletion script for the specified shell
   create      Creates a new key in the default location
@@ -30,11 +31,13 @@ Available Commands:
   help        Help about any command
   info        Reads space info and all values at space
   lifeline    Extends the life of a given prefix
+  move        Transfers a space to another address
   resolve     Reads a value at space/key
   set         Writes a key-value pair for the given prefix
+  transfer    Transfers units to another address
 
 Flags:
-      --endpoint string           RPC Endpoint for VM (default "http://127.0.0.1:9650")
+      --endpoint string           RPC Endpoint for VM (default "https://memeshowdown.com")
   -h, --help                      help for spaces-cli
       --private-key-file string   private key file path (default ".spaces-cli-pk")
 
@@ -97,12 +100,12 @@ _Provide your intent and get back a transaction to sign._
 
 #### Transaction Types
 ```
-Claim    {type,space}
-Lifeline {type,space,units}
-Set      {type,space,key,value}
-Delete   {type,space,key}
-Move     {type,space,to}
-Transfer {type,to,units}
+claim    {type,space}
+lifeline {type,space,units}
+set      {type,space,key,value}
+delete   {type,space,key}
+move     {type,space,to}
+transfer {type,to,units}
 
 ```
 
@@ -215,6 +218,32 @@ Transfer {type,to,units}
 >>> {"balance":<uint64>}
 ```
 
+## spacesvm.recentActivity
+```
+<<< POST
+{
+  "jsonrpc": "2.0",
+  "method": "spacesvm.recentActivity",
+  "params":{},
+  "id": 1
+}
+>>> {"activity":[<chain.Activity>,...]}
+```
+
+### chain.Activity
+```
+{
+  "timestamp":<unix>,
+  "sender":<address>,
+  "txId":<ID>,
+  "type":<string>,
+  "space":<string>,
+  "key":<string>,
+  "to":<hex encoded>,
+  "units":<uint64>
+}
+```
+
 # Advanced Public Endpoints (`/public`)
 
 ## spacesvm.suggestedRawFee
@@ -247,7 +276,7 @@ _Can use this to get the current fee rate._
 # Creating Transactions
 ```
 1) spacesvm.claimed {"space":"patrick"} => Yes/No
-2) spacesvm.suggestedFee {"input":{"type":"Claim", "space":"patrick"}} => {"typedData":<EIP-712 Typed Data>, "cost":<total fee>}
+2) spacesvm.suggestedFee {"input":{"type":"claim", "space":"patrick"}} => {"typedData":<EIP-712 Typed Data>, "cost":<total fee>}
 3) sign EIP-712 Typed Data
 4) spacesvm.issueTx {"typedData":<from spacesvm.suggestedFee>, "signature":<sig from step 3>} => {"txId":<ID>}
 5) [loop] spacesvm.hasTx {"txId":<ID>} => {"accepted":true"}

chain/activity.go

@@ -0,0 +1,19 @@
+// Copyright (C) 2019-2021, Ava Labs, Inc. All rights reserved.
+// See the file LICENSE for licensing terms.
+
+package chain
+
+import (
+	"github.com/ava-labs/avalanchego/ids"
+)
+
+type Activity struct {
+	Tmstmp int64  `serialize:"true" json:"timestamp"`
+	Sender string `serialize:"true" json:"sender"`
+	TxID   ids.ID `serialize:"true" json:"txId"`
+	Typ    string `serialize:"true" json:"type"`
+	Space  string `serialize:"true" json:"space,omitempty"`
+	Key    string `serialize:"true" json:"key,omitempty"`
+	To     string `serialize:"true" json:"to,omitempty"` // common.Address will be 0x000 when not populated
+	Units  uint64 `serialize:"true" json:"units,omitempty"`
+}

chain/claim_tx.go

@@ -110,3 +110,10 @@ func (c *ClaimTx) TypedData() *tdata.TypedData {
 		},
 	)
 }
+
+func (c *ClaimTx) Activity() *Activity {
+	return &Activity{
+		Typ:   Claim,
+		Space: c.Space,
+	}
+}

chain/decoder.go

@@ -15,12 +15,12 @@ import (
 )
 
 const (
-	Claim    = "Claim"
-	Lifeline = "Lifeline"
-	Set      = "Set"
-	Delete   = "Delete"
-	Move     = "Move"
-	Transfer = "Transfer"
+	Claim    = "claim"
+	Lifeline = "lifeline"
+	Set      = "set"
+	Delete   = "delete"
+	Move     = "move"
+	Transfer = "transfer"
 )
 
 type Input struct {

chain/delete_tx.go

@@ -81,3 +81,11 @@ func (d *DeleteTx) TypedData() *tdata.TypedData {
 		},
 	)
 }
+
+func (d *DeleteTx) Activity() *Activity {
+	return &Activity{
+		Typ:   Delete,
+		Space: d.Space,
+		Key:   d.Key,
+	}
+}

chain/lifeline_tx.go

@@ -84,3 +84,11 @@ func (l *LifelineTx) TypedData() *tdata.TypedData {
 		},
 	)
 }
+
+func (l *LifelineTx) Activity() *Activity {
+	return &Activity{
+		Typ:   Lifeline,
+		Space: l.Space,
+		Units: l.Units,
+	}
+}

chain/move_tx.go

@@ -78,9 +78,17 @@ func (m *MoveTx) TypedData() *tdata.TypedData {
 		},
 		tdata.TypedDataMessage{
 			tdSpace:   m.Space,
-			tdTo:      m.To,
+			tdTo:      m.To.Hex(),
 			tdPrice:   strconv.FormatUint(m.Price, 10),
 			tdBlockID: m.BlockID.String(),
 		},
 	)
 }
+
+func (m *MoveTx) Activity() *Activity {
+	return &Activity{
+		Typ:   Move,
+		Space: m.Space,
+		To:    m.To.Hex(),
+	}
+}

chain/set_tx.go

@@ -122,3 +122,11 @@ func (s *SetTx) TypedData() *tdata.TypedData {
 		},
 	)
 }
+
+func (s *SetTx) Activity() *Activity {
+	return &Activity{
+		Typ:   Set,
+		Space: s.Space,
+		Key:   s.Key,
+	}
+}

chain/transfer_tx.go

@@ -65,10 +65,18 @@ func (t *TransferTx) TypedData() *tdata.TypedData {
 			{Name: tdBlockID, Type: tdString},
 		},
 		tdata.TypedDataMessage{
-			tdTo:      t.To,
+			tdTo:      t.To.Hex(),
 			tdUnits:   strconv.FormatUint(t.Units, 10),
 			tdPrice:   strconv.FormatUint(t.Price, 10),
 			tdBlockID: t.BlockID.String(),
 		},
 	)
 }
+
+func (t *TransferTx) Activity() *Activity {
+	return &Activity{
+		Typ:   Transfer,
+		To:    t.To.Hex(),
+		Units: t.Units,
+	}
+}

chain/tx.go

@@ -136,3 +136,10 @@ func (t *Transaction) Execute(g *Genesis, db database.Database, blk *StatelessBl
 	rewardAmount := t.FeeUnits(g) * blk.Price * g.LotteryRewardMultipler / g.LotteryRewardDivisor
 	return ApplyReward(db, blk.ID(), t.ID(), t.sender, rewardAmount)
 }
+
+func (t *Transaction) Activity() *Activity {
+	activity := t.UnsignedTransaction.Activity()
+	activity.Sender = t.sender.Hex()
+	activity.TxID = t.id
+	return activity
+}