8 Inline Action to External Contract

Search…
This section of the guide provides instructions for sending actions to an external contract. The examples of the execution of instructions are shown in the contract, where the performed actions are kept.
8.1 Addressbook counter address contract
Log into CONTRACTS_DIR and create a directory there with the name abcounter, as well as the file abcounter.cpp.
1
cd CONTRACTS_DIR
2
mkdir abcounter
3
cd abcounter
4
touch abcounter.cpp
Copied!
Open the abcounter.cpp file and write the following program text into it:
1
#include <eosiolib/eosio.hpp>
2
​
3
using namespace eosio;
4
​
5
class [[eosio::contract]] abcounter : public eosio::contract {
6
  private:
7
    struct [[eosio::table]] counter {
8
      name key;
9
      uint64_t emplaced;
10
      uint64_t modified;
11
      uint64_t erased;
12
      uint64_t primary_key() const {
13
      return key.value;
14
    }
15
  };
16
​
17
    using count_index = eosio::multi_index<"counter"_n, counter>;
18
  public:
19
    using contract::contract;
20
​
21
    abcounter(name receiver, name code,  datastream<const char*> ds):
22
contract(receiver, code, ds) {}
23
​
24
    [[eosio::action]]
25
    void count(name user, std::string type) {
26
      require_auth( name("addressbook"));
27
      count_index counts(name(_code), _code.value);
28
      auto iterator = counts.find(user.value);
29
​
30
      if (iterator == counts.end()) {
31
        counts.emplace("addressbook"_n, [&]( auto& row ) {
32
          row.key = user;
33
          row.emplaced = (type == "emplace") ? 1 : 0;
34
          row.modified = (type == "modify") ? 1 : 0;
35
          row.erased = (type == "erase") ? 1 : 0;
36
        });
37
      }
38
      else {
39
        counts.modify(iterator, "addressbook"_n, [&]( auto& row ) {
40
          if(type == "emplace") { row.emplaced += 1; }
41
          if(type == "modify") { row.modified += 1; }
42
          if(type == "erase") { row.erased += 1; }
43
        });
44
      }
45
    }
46
};
47
​
48
EOSIO_DISPATCH( abcounter, (count));
Copied!
The peculiarity of this text is that it has a restriction on calls to an action for the contract account. For restriction, use require_auth for the addressbook contract. Only the addressbook contract account is authorized to perform require_auth. The count action is not sent by the user, but by the addressbook contract.
1
require_auth( name("addressbook"));
Copied!
8.2 Create an account for abcounter contract
1
cleos create account cyber abcounter YOUR_PUBLIC_KEY
Copied!
8.3 Compile and install the abcounter contract
1
eosio-cpp -o abcounter.wasm abcounter.cpp --abigen
2
cleos set contract abcounter CONTRACTS_DIR/abcounter
Copied!
8.4 Modify the contract addressbook to send inline actions to a new abcounter contract
1
cd CONTRACTS_DIR/addressbook
Copied!
Open the file addressbook.cpp and create in it another helper named increment_counter in the private part of the contract.
1
void increment_counter(name user, std::string type) {
2
​
3
  action counter = action(
4
    permission_level{get_self(),"active"_n},
5
    "abcounter"_n,
6
    "count"_n,
7
    std::make_tuple(user, type)
8
  );
9
​
10
  counter.send();
11
}
Copied!
The action body contains:
выдача разрешения уровня active .Для разрешения функция get_self() возвращает текущий контракт addressbook;  
the abcounter account name of the contract;  
the count action to call;  
data, username and line type.
Add calls to «set», «modify» and «erase» helpers.
1
//Emplace
2
increment_counter(user, "emplace");
3
//Modify
4
increment_counter(user, "modify");
5
//Erase
6
increment_counter(user, "erase");
Copied!
As a result, the addressbook.cpp file should look like this:
1
#include <eosiolib/eosio.hpp>
2
#include <eosiolib/print.hpp>
3
​
4
using namespace eosio;
5
​
6
class [[eosio::contract]] addressbook : public eosio::contract {
7
​
8
  private:
9
    struct [[eosio::table]] person {
10
      name key;
11
      std::string first_name;
12
      std::string last_name;
13
      uint64_t age;
14
      std::string street;
15
      std::string city;
16
      std::string state;
17
​
18
      uint64_t primary_key() const { return key.value; }
19
​
20
      uint64_t get_secondary_1() const { return age;}
21
​
22
    };
23
​
24
    void send_summary(name user, std::string message) {
25
      action(
26
        permission_level{get_self(),"active"_n},
27
        get_self(),
28
        "notify"_n,
29
        std::make_tuple(user, name{user}.to_string() + message)
30
      ).send();
31
    };
32
​
33
    void increment_counter(name user, std::string type) {
34
​
35
      action counter = action(
36
        permission_level{get_self(),"active"_n},
37
        "abcounter"_n,
38
        "count"_n,
39
        std::make_tuple(user, type)
40
      );
41
​
42
    counter.send();
43
  }
44
​
45
  typedef eosio::multi_index<"person"_n, person,
46
    indexed_by<"byage"_n, member<person, uint64_t, &person::get_secondary_1>>
47
  > address_index;
48
  public:
49
    using contract::contract;
50
​
51
    addressbook(name receiver, name code,  datastream<const char*> ds):  contract(receiver, code, ds) {}
52
​
53
    [[eosio::action]]
54
    void upsert(name user, std::string first_name, std::string last_name, uint64_t age, std::string street, std::string city, std::string state) {
55
      require_auth(user);
56
      address_index addresses(_code, _code.value);
57
      auto iterator = addresses.find(user.value);
58
      if( iterator == addresses.end() )
59
      {
60
        addresses.emplace(user, [&]( auto& row ) {
61
         row.key = user;
62
         row.first_name = first_name;
63
         row.last_name = last_name;
64
         row.age = age;
65
         row.street = street;
66
         row.city = city;
67
         row.state = state;
68
​
69
         send_summary(user, " successfully emplaced record to addressbook");
70
         increment_counter(user, "emplace");
71
        });
72
      }
73
      else {
74
        std::string changes;
75
        addresses.modify(iterator, user, [&]( auto& row ) {
76
          row.key = user;
77
          row.first_name = first_name;
78
          row.last_name = last_name;
79
          row.age = age;
80
          row.street = street;
81
          row.city = city;
82
          row.state = state;
83
​
84
          send_summary(user, " successfully modified record to addressbook");
85
          increment_counter(user, "modify");
86
      });
87
​
88
    }
89
  }
90
​
91
  [[eosio::action]]
92
    void erase(name user) {
93
      require_auth(user);
94
​
95
      address_index addresses(_code, _code.value);
96
      auto iterator = addresses.find(user.value);
97
      eosio_assert(iterator != addresses.end(), "Record does not exist");
98
      addresses.erase(iterator);
99
      send_summary(user, " successfully erased record from addressbook");
100
      increment_counter(user, "erase");
101
    }
102
​
103
  [[eosio::action]]
104
    void notify(name user, std::string msg) {
105
      require_auth(get_self());
106
      require_recipient(user);
107
    }
108
​
109
  };
110
​
111
EOSIO_DISPATCH( addressbook, (upsert)(notify)(erase));
Copied!
8.5 Recompile and set the addressbook contract
Since the changes should not affect the ABI, you do not need to re-edit the ABI file (make sure that this file has not been updated).
1
eosio-cpp -o addressbook.wasm addressbook.cpp
2
cleos set contract addressbook CONTRACTS_DIR/addressbook
Copied!
8.6 Perform testing of sending an action from an addressbook contract to an abcounter contract
Before testing, make sure that the abcounter and addressbook contracts are set.
8.6.1 Verify that a notification is sent to the abcounter contract, as well as a change in the entry in the addressbook contract table by executing:
1
cleos push action addressbook upsert '["alice", "alice", "liddell", 19, "123 drink me way", "wonderland", "amsterdam"]' -p [email protected]
Copied!
The action is considered successful if the output contains the following information:
1
executed transaction: ...
2
#   addressbook <= addressbook::upsert          {"user":"alice","first_name":"alice","last_name":"liddell","street":"123 drink me way","city":"wonde...
3
#   addressbook <= addressbook::notify          {"user":"alice","msg":"alice successfully modified record in addressbook"}
4
#         alice <= addressbook::notify          {"user":"alice","msg":"alice successfully modified record in addressbook"}
5
#     abcounter <= abcounter::count             {"user":"alice","type":"modify"}
Copied!
8.6.2 Check the appearance of a row in the table for the alice user.
1
cleos get table abcounter abcounter counts --lower alice --limit 1
Copied!
The action is considered successful if the result is the following:
1
{
2
  "rows": [{
3
      "key": "alice",
4
      "emplaced": 1,
5
      "modified": 0,
6
      "erased": 0
7
    }
8
  ],
9
  "more": false
10
}
Copied!
8.6.3 Check that the upsert method modifies the record.
1
cleos push action addressbook upsert '["alice", "alice", "liddell", 21,"1 there we go", "wonderland", "amsterdam"]' -p [email protected]
Copied!
The actions are considered successfully completed if the resulting output contains the following information:
1
executed transaction: …
2
#   addressbook <= addressbook::upsert          {"user":"alice","first_name":"alice","last_name":"liddell","street":"1 coming down","city":"normalla...
3
#   addressbook <= addressbook::notify          {"user":"alice","msg":"alice successfully emplaced record to addressbook"}
4
>> Notified
5
#         alice <= addressbook::notify          {"user":"alice","msg":"alice successfully emplaced record to addressbook"}
6
#     abcounter <= abcounter::count             {"user":"alice","type":"emplace"}
7
warning: transaction executed locally, but may not be confirmed by the network yet    ]
Copied!
8.6.4 Verify the liquidation of the alice user entry from the table by running:
1
cleos push action addressbook erase '["alice"]' -p [email protected]
Copied!
The action is considered to be successfully completed if the resulting output contains the following information:
1
executed transaction: ...
2
#   addressbook <= addressbook::erase           {"user":"alice"}
3
>> Erased
4
#   addressbook <= addressbook::notify          {"user":"alice","msg":"alice successfully erased record from addressbook"}
5
>> Notified
6
#         alice <= addressbook::notify          {"user":"alice","msg":"alice successfully erased record from addressbook"}
7
#     abcounter <= abcounter::count             {"user":"alice","type":"erase"}
8
warning: transaction executed locally, but may not be confirmed by the network yet    ]
9
Toaster:addressbook sandwich$
Copied!
8.6.5 Test the ability to manipulate abcounter contract data by executing:
1
cleos push action abcounter count '["alice", "erase"]' -p [email protected]
2
cleos get table abcounter abcounter counts --lower alice
Copied!
The abcounter contract table should contain the following information:
1
{
2
  "rows": [{
3
      "key": "alice",
4
      "emplaced": 1,
5
      "modified": 1,
6
      "erased": 1
7
    }
8
  ],
9
  "more": false
10
}
Copied!
7 Adding Inline Actions
9 Conclusion
Last modified 3yr ago
Copy link
Contents
8.1 Addressbook counter address contract
8.2 Create an account for abcounter contract
8.3 Compile and install the abcounter contract
8.4 Modify the contract addressbook to send inline actions to a new abcounter contract
8.5 Recompile and set the addressbook contract
8.6 Perform testing of sending an action from an addressbook contract to an abcounter contract