Skip to content

Commit

Permalink
Feature: Added section explaining inter contract calls (#183)
Browse files Browse the repository at this point in the history
* feat: Added section explaining inter contract calls

* fix: Added point of Initializing contract state in inter-contract calls

* fix: fixed english
  • Loading branch information
vasmohi authored Aug 26, 2024
1 parent 590ddfd commit 29e65cb
Showing 1 changed file with 38 additions and 0 deletions.
38 changes: 38 additions & 0 deletions docs/quick-start/developers/lottery-game-smart-contract/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -1380,6 +1380,44 @@ Enter the required param <symbol>: ELF
Enter the required param <owner>: $WALLET_ADDRESS
```

## Understanding Inter-Contract Calls in aelf

In this section, we'll explore how inter-contract calls work in the aelf blockchain using the lottery game example from the tutorial. This will help you understand how different smart contracts can interact to perform complex operations.

### 1. **Smart Contract Overview**
- **Lottery Contract**: Manages the game, including buying tickets, drawing winners, and distributing prizes.
- **Token Contract**: Handles the token transactions needed for buying lottery tickets.

### 2. **Ticket Purchase Process**
- **Initiating Purchase**: When a user wants to buy a lottery ticket, they interact with the Lottery Contract.
- **Token Transfer Requirement**: The Lottery Contract must verify that the user has enough tokens and transfer those tokens to the lottery’s account to complete the purchase.

### 3. **Initializing Contract Reference State**
- **Setting Contract Address**: The Lottery Contract must first initialize its reference to the Token Contract by setting the correct contract address in its state.

### 4. **Making an Inter-Contract Call**
- **Calling Token Contract**: The Lottery Contract needs to interact with the Token Contract to transfer tokens.
- **Method Invocation**: It calls a method in the Token Contract, such as `Transfer`.
- **Parameters**: The call includes details like the sender’s address, the recipient’s address (the lottery account), and the amount of tokens.
- **Encoding and Sending**: The parameters are encoded into a transaction format and sent to the Token Contract.

### 5. **Processing in the Token Contract**
- **Token Transfer**: The Token Contract processes the transfer request by deducting tokens from the user’s account and adding them to the lottery account.
- **Return Response**: The Token Contract then returns a result indicating whether the transfer was successful or if it failed.

### 6. **Handling the Response**
- **Lottery Contract’s Role**: Once the Lottery Contract receives the response from the Token Contract, it checks if the transfer was successful.
- **Next Steps**: If successful, the Lottery Contract updates the user's lottery ticket entries and continues with the game logic.

### 7. **Authorization and Security**
- **Permission Checks**: Ensures that the Lottery Contract is authorized to invoke methods in the Token Contract.
- **Secure Transactions**: Ensures that token transfers are secure and correctly authorized.

### 8. **Error Handling**
- **Failure Management**: If the token transfer fails (e.g., due to insufficient funds), the Lottery Contract handles the error by potentially reverting the transaction or notifying the user.

By following these steps, you can see how inter-contract calls in aelf allow different contracts to work together smoothly. This modular approach helps in building complex applications like a lottery game by ensuring secure and authorized interactions between contracts.


## 🎯 Conclusion

Expand Down

0 comments on commit 29e65cb

Please sign in to comment.