Merge pull request #667 from cosmos/bucky/ibc-mvp1

comment and a dep update

Gopkg.lock

@@ -463,6 +463,6 @@
 [solve-meta]
   analyzer-name = "dep"
   analyzer-version = 1
-  inputs-digest = "3d1aebf798b51882ed5281b0ca0a3766c32cdb08592de57dd3d574a4b3e67987"
+  inputs-digest = "64881873c2a0899c3d6920de588c06a2b59e6b072e1a3d7e676e906cb7d5ad0e"
   solver-name = "gps-cdcl"
   solver-version = 1

x/ibc/handler.go

@@ -21,7 +21,7 @@ func NewHandler(ibcm IBCMapper, ck bank.CoinKeeper) sdk.Handler {
 	}
 }
 
-// Handle outgoing IBC packets.
+// IBCTransferMsg deducts coins from the account and creates an egress IBC packet.
 func handleIBCTransferMsg(ctx sdk.Context, ibcm IBCMapper, ck bank.CoinKeeper, msg IBCTransferMsg) sdk.Result {
 	packet := msg.IBCPacket
 
@@ -38,6 +38,7 @@ func handleIBCTransferMsg(ctx sdk.Context, ibcm IBCMapper, ck bank.CoinKeeper, m
 	return sdk.Result{}
 }
 
+// IBCReceiveMsg adds coins to the destination address and creates an ingress IBC packet.
 func handleIBCReceiveMsg(ctx sdk.Context, ibcm IBCMapper, ck bank.CoinKeeper, msg IBCReceiveMsg) sdk.Result {
 	packet := msg.IBCPacket