comment cleanup

Author: andrewliu08

packages/contract/src/pay/DaimoPay.sol

@@ -144,10 +144,10 @@ contract DaimoPay {
         emit Start({intentAddr: address(intentContract), intent: intent});
     }
 
-    /// Completes intent immediately on chain B. The caller relayer makes a
-    /// transfer atomically in the same transaction and calls this function. The
-    /// relayer transfers some amount of token, and can make arbitrary calls to
-    /// convert it into the required amount of finalCallToken.
+    /// Completes intent immediately on chain B. The relayer calls this function
+    /// and atomically makes a transfer in the same transaction. The relayer
+    /// can make arbitrary calls to convert the transferred tokens into the
+    /// required amount of finalCallToken.
     ///
     /// Later, when the slower bridge transfer arrives, the relayer will be able
     /// to claim (bridgeTokenOut.token, bridgeTokenOut.amount), keeping the

packages/contract/src/pay/PayIntent.sol

@@ -13,7 +13,7 @@ struct PayIntent {
     /// @dev Intent only executes on given target chain.
     uint256 toChainId;
     /// @dev Possible output tokens after bridging to the destination chain.
-    ///      Currently, ative token is not supported as a bridge token output.
+    ///      Currently, native token is not supported as a bridge token output.
     TokenAmount[] bridgeTokenOutOptions;
     /// @dev Expected token amount after swapping on the destination chain.
     TokenAmount finalCallToken;

packages/contract/test/pay/DaimoPay.t.sol

@@ -300,13 +300,16 @@ contract DaimoPayTest is Test {
         require(_toToken.balanceOf(intentAddr) == 100);
     }
 
-    function testSimpleRefundAfterClaim() public {
+    // Test refundIntent for a same-chain intent. The refund should only be
+    // possible after the intent has been claimed.
+    function testSameChainRefundAfterClaim() public {
         testSimpleSameChainStart();
 
         PayIntent memory intent = getSimplePayIntent();
         address intentAddr = intentFactory.getIntentAddress(intent);
 
-        // Since we are on the dest chain already, we *cannot* refund on start.
+        // Since we are on the dest chain already, we *cannot* refund after
+        // startIntent.
         vm.expectRevert(bytes("DP: not claimed"));
         dp.refundIntent({intent: intent, token: _toToken});