Add STX Price Management Functions with Authorization and Validation

[emmanuelist]

Description

This pull request implements key features to manage the STX price in the smart contract, including functions for updating the price and interval with authorization checks, data validation, and event logging. It also provides read-only functions for retrieving the current price and last update time.

Key Features Implemented:

1. Constants and Data Variables:

   • Defined constants for:
     • contract-owner: Authorized to make updates.
     • error-codes: Used for invalid price, unauthorized access, and invalid interval.
     • update-interval: Default interval between price updates.
   • Defined data variables:
     • stx-price: Stores the current STX price.
     • last-update-time: Stores the timestamp of the last update.
     • update-interval: Stores the configurable update interval.

2. Public Function: set-stx-price:

   • Authorization: Only the contract owner can update the STX price.
   • Validation:
     • Price must be greater than zero.
     • Ensure the update interval has passed since the last update.
   • Update Process: Updates the STX price and last update time.
   • Event: Prints a log event indicating the STX price has been successfully updated.

3. Public Function: set-update-interval:

   • Authorization: Only the contract owner can update the interval.
   • Validation: New interval must be within a valid range.
   • Update: Modifies the update interval data variable.

4. Read-only Functions:

   • get-stx-price: Returns the current STX price.
   • get-last-update: Returns the timestamp of the last STX price update.

Additional Notes:

• Added tests for all new functions using @stacks/clarity-cli.
• Function documentation is included within the contract.
• Error handling is implemented using predefined error codes.

Commits Included:

1. Define Constants and Data Variables

   • Added constants for contract owner, error codes, and update interval.
   • Added data variables for STX price, last update time, and update interval.

2. Implement set-stx-price Function

   • Implemented public function for updating the STX price with authorization, validation, and event logging.

3. Implement Read-only Functions

   • Implemented get-stx-price and get-last-update read-only functions.

4. Implement set-update-interval Function

   • Implemented the public function for updating the interval with authorization and validation.

---

Checklist:

• Constants and data variables defined.
• Public functions set-stx-price and set-update-interval implemented.
• Read-only functions get-stx-price and get-last-update added.
• Tests added for all functions.
• Function comments and event logs included.