Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

Personal Finance Management Smart Contract

A comprehensive Clarity smart contract for managing personal finances on the Stacks blockchain. This contract provides users with tools to track income, expenses, budgets, and savings goals in a decentralized manner.

Features

Core Functionality

  • User Profile Management: Initialize and manage personal financial profiles
  • Transaction Tracking: Record income and expense transactions with categories
  • Budget Management: Create and monitor spending budgets with utilization tracking
  • Savings Goals: Set financial targets with deadline tracking and progress monitoring
  • Category Management: Customize expense and income categories

Analytics & Reporting

  • Real-time budget utilization percentage calculation
  • Savings goal progress tracking
  • Comprehensive financial summaries with net worth calculation
  • Transaction history with timestamps

Contract Structure

Data Maps

  • user-profiles: Stores user financial summaries and totals
  • transactions: Records all income/expense transactions
  • budgets: Manages spending budgets by category
  • savings-goals: Tracks financial goals and progress
  • user-categories: Custom category lists per user

Error Codes

  • u100: Owner-only function access denied
  • u101: Requested data not found
  • u102: Invalid amount (must be > 0 and <= 1,000,000,000,000)
  • u103: Insufficient funds
  • u104: Invalid category (empty or too long)
  • u105: Unauthorized access to user data
  • u106: Invalid input data

Public Functions

Profile Management

(initialize-profile)

About

This is a comprehensive Personal Finance Management Smart Contract built for the Stacks blockchain that enables users to track and manage their financial activities on-chain.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors