diff --git a/package-lock.json b/package-lock.json
index 37c59d9..f1d4d23 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -9,7 +9,7 @@
 			"version": "0.1.0",
 			"dependencies": {
 				"@hookform/resolvers": "^5.9.1",
-				"@stellar/freighter-api": "^6.0.1",
+				"@stellar/stellar-sdk": "^17.2.1",
 				"html2canvas": "^1.4.1",
 				"lucide-react": "^1.7.0",
 				"qrcode": "^1.5.1",
@@ -933,6 +933,23 @@
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
 			}
 		},
+		"node_modules/@exodus/bytes": {
+			"version": "1.16.0",
+			"resolved": "https://registry.npmjs.org/@exodus/bytes/-/bytes-1.16.0.tgz",
+			"integrity": "sha512-IcpW84uEn3N7ETtNZMlxKhfl6Pec8rUNGOTBtWbK1FKhJxIFAptZyVrvVRVBimAJxJCgc3PxepxkdWWG4DVzfA==",
+			"license": "MIT",
+			"engines": {
+				"node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+			},
+			"peerDependencies": {
+				"@noble/hashes": "^1.8.0 || ^2.0.0"
+			},
+			"peerDependenciesMeta": {
+				"@noble/hashes": {
+					"optional": true
+				}
+			}
+		},
 		"node_modules/@hookform/resolvers": {
 			"version": "5.9.1",
 			"resolved": "https://registry.npmjs.org/@hookform/resolvers/-/resolvers-5.9.1.tgz",
@@ -1227,6 +1244,27 @@
 				"@jridgewell/sourcemap-codec": "^1.4.14"
 			}
 		},
+		"node_modules/@noble/ed25519": {
+			"version": "3.2.0",
+			"resolved": "https://registry.npmjs.org/@noble/ed25519/-/ed25519-3.2.0.tgz",
+			"integrity": "sha512-criDgRlnUA09hchYrTy/JUWPIEap5rZxQe6wDWzRx51oWWpDRcUpuNzlgPxDJaOK6AsW9c0wKcj3rKRv6t+bPQ==",
+			"license": "MIT",
+			"funding": {
+				"url": "https://paulmillr.com/funding/"
+			}
+		},
+		"node_modules/@noble/hashes": {
+			"version": "2.4.0",
+			"resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-2.4.0.tgz",
+			"integrity": "sha512-X5XaVWZIBCT7HHZGm5I7ZQXDwLG+bGXuSrMQAW+7Zvl87h1kmc1ZB1VSRJcpUfoUrGQp4Fkoxm5kZ+Ms+aW+eA==",
+			"license": "MIT",
+			"engines": {
+				"node": ">= 20.19.0"
+			},
+			"funding": {
+				"url": "https://paulmillr.com/funding/"
+			}
+		},
 		"node_modules/@nodelib/fs.scandir": {
 			"version": "2.1.5",
 			"resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
@@ -1642,26 +1680,51 @@
 			"integrity": "sha512-e7Mew686owMaPJVNNLs55PUvgz371nKgwsc4vxE49zsODpJEnxgxRo2y/OKrqueavXgZNMDVj3DdHFlaSAeU8g==",
 			"license": "MIT"
 		},
-		"node_modules/@stellar/freighter-api": {
-			"version": "6.0.1",
-			"resolved": "https://registry.npmjs.org/@stellar/freighter-api/-/freighter-api-6.0.1.tgz",
-			"integrity": "sha512-eqwakEqSg+zoLuPpSbKyrX0pG8DQFzL/J5GtbfuMCmJI+h+oiC9pQ5C6QLc80xopZQKdGt8dUAFCmDMNdAG95w==",
+		"node_modules/@stellar/js-xdr": {
+			"version": "5.0.0",
+			"resolved": "https://registry.npmjs.org/@stellar/js-xdr/-/js-xdr-5.0.0.tgz",
+			"integrity": "sha512-HBDNKnxr+ecdaEmbZ0mcKkirOF8tXXEbWSw34P3wT40Tn3g+u+cCH17xAWZymzscq8cojHB8340pR8QNVaD32w==",
 			"license": "Apache-2.0",
-			"dependencies": {
-				"buffer": "6.0.3",
-				"semver": "7.7.1"
+			"engines": {
+				"node": ">=22.0.0",
+				"pnpm": ">=10.0.0"
 			}
 		},
-		"node_modules/@stellar/freighter-api/node_modules/semver": {
-			"version": "7.7.1",
-			"resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz",
-			"integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==",
-			"license": "ISC",
+		"node_modules/@stellar/stellar-sdk": {
+			"version": "17.2.1",
+			"resolved": "https://registry.npmjs.org/@stellar/stellar-sdk/-/stellar-sdk-17.2.1.tgz",
+			"integrity": "sha512-kIyfnZ2zCOqV8SUJcsk9buBOvhH1wsLU7KAzqAJyY7AgmD+KdvLTMpI1gcYdhGSakuDG5s6xSO4EN9HZTxpm8g==",
+			"license": "Apache-2.0",
+			"dependencies": {
+				"@exodus/bytes": "^1.15.1",
+				"@noble/ed25519": "^3.1.0",
+				"@noble/hashes": "^2.2.0",
+				"@stellar/js-xdr": "^5.0.0",
+				"@types/json-schema": "^7.0.15",
+				"axios": "1.20.0",
+				"bignumber.js": "^11.1.4",
+				"commander": "^14.0.3",
+				"eventsource": "^4.1.0",
+				"feaxios": "^0.0.23",
+				"smol-toml": "^1.6.1",
+				"uint8array-extras": "^1.5.0"
+			},
 			"bin": {
-				"semver": "bin/semver.js"
+				"stellar-contract-bindings-typescript": "bin/stellar-contract-bindings-typescript",
+				"stellar-js": "bin/stellar-js",
+				"stellar-sdk": "bin/stellar-js"
 			},
 			"engines": {
-				"node": ">=10"
+				"node": ">=22.12.0"
+			}
+		},
+		"node_modules/@stellar/stellar-sdk/node_modules/commander": {
+			"version": "14.0.3",
+			"resolved": "https://registry.npmjs.org/commander/-/commander-14.0.3.tgz",
+			"integrity": "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==",
+			"license": "MIT",
+			"engines": {
+				"node": ">=20"
 			}
 		},
 		"node_modules/@swc/core": {
@@ -2131,7 +2194,6 @@
 			"version": "7.0.15",
 			"resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
 			"integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
-			"dev": true,
 			"license": "MIT"
 		},
 		"node_modules/@types/node": {
@@ -2743,8 +2805,7 @@
 		"node_modules/asynckit": {
 			"version": "0.4.0",
 			"resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
-			"integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
-			"dev": true
+			"integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q=="
 		},
 		"node_modules/autoprefixer": {
 			"version": "10.6.1",
@@ -2793,6 +2854,43 @@
 				"node": ">=4"
 			}
 		},
+		"node_modules/axios": {
+			"version": "1.20.0",
+			"resolved": "https://registry.npmjs.org/axios/-/axios-1.20.0.tgz",
+			"integrity": "sha512-r8aOh8j9cGKpgQAqpzrUHnSIc6a59Y3Xf/cv8sy1DrHCkZHzQGEuoq1tARk6qSyDdtQGSDgpb9kFlruzPvrgwg==",
+			"license": "MIT",
+			"dependencies": {
+				"follow-redirects": "^1.16.0",
+				"form-data": "^4.0.6",
+				"https-proxy-agent": "^5.0.1",
+				"proxy-from-env": "^2.1.0"
+			}
+		},
+		"node_modules/axios/node_modules/agent-base": {
+			"version": "6.0.2",
+			"resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz",
+			"integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==",
+			"license": "MIT",
+			"dependencies": {
+				"debug": "4"
+			},
+			"engines": {
+				"node": ">= 6.0.0"
+			}
+		},
+		"node_modules/axios/node_modules/https-proxy-agent": {
+			"version": "5.0.1",
+			"resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",
+			"integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==",
+			"license": "MIT",
+			"dependencies": {
+				"agent-base": "6",
+				"debug": "4"
+			},
+			"engines": {
+				"node": ">= 6"
+			}
+		},
 		"node_modules/balanced-match": {
 			"version": "4.0.4",
 			"resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
@@ -2845,6 +2943,12 @@
 				"node": ">=6.0.0"
 			}
 		},
+		"node_modules/bignumber.js": {
+			"version": "11.1.5",
+			"resolved": "https://registry.npmjs.org/bignumber.js/-/bignumber.js-11.1.5.tgz",
+			"integrity": "sha512-6WmzCNtUnfKpbozq+hOgWaZMMzORmYBwF1xZScyoIX3QRYWeKTtxxwDOW5tIz7C9BdjkIYHGTcelCLkXg0mndw==",
+			"license": "MIT"
+		},
 		"node_modules/binary-extensions": {
 			"version": "2.3.0",
 			"resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
@@ -2946,7 +3050,6 @@
 			"version": "1.0.2",
 			"resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
 			"integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
-			"dev": true,
 			"dependencies": {
 				"es-errors": "^1.3.0",
 				"function-bind": "^1.1.2"
@@ -3119,7 +3222,6 @@
 			"version": "1.0.8",
 			"resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
 			"integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
-			"dev": true,
 			"dependencies": {
 				"delayed-stream": "~1.0.0"
 			},
@@ -3251,7 +3353,6 @@
 			"version": "4.4.3",
 			"resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
 			"integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
-			"dev": true,
 			"license": "MIT",
 			"dependencies": {
 				"ms": "^2.1.3"
@@ -3292,7 +3393,6 @@
 			"version": "1.0.0",
 			"resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
 			"integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
-			"dev": true,
 			"engines": {
 				"node": ">=0.4.0"
 			}
@@ -3349,7 +3449,6 @@
 			"version": "1.0.1",
 			"resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
 			"integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
-			"dev": true,
 			"dependencies": {
 				"call-bind-apply-helpers": "^1.0.1",
 				"es-errors": "^1.3.0",
@@ -3388,7 +3487,6 @@
 			"version": "1.0.1",
 			"resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
 			"integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
-			"dev": true,
 			"engines": {
 				"node": ">= 0.4"
 			}
@@ -3397,7 +3495,6 @@
 			"version": "1.3.0",
 			"resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
 			"integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
-			"dev": true,
 			"engines": {
 				"node": ">= 0.4"
 			}
@@ -3413,7 +3510,6 @@
 			"version": "1.1.2",
 			"resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
 			"integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
-			"dev": true,
 			"dependencies": {
 				"es-errors": "^1.3.0"
 			},
@@ -3425,7 +3521,6 @@
 			"version": "2.1.0",
 			"resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
 			"integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
-			"dev": true,
 			"dependencies": {
 				"es-errors": "^1.3.0",
 				"get-intrinsic": "^1.2.6",
@@ -3757,6 +3852,27 @@
 				"node": ">=0.10.0"
 			}
 		},
+		"node_modules/eventsource": {
+			"version": "4.1.1",
+			"resolved": "https://registry.npmjs.org/eventsource/-/eventsource-4.1.1.tgz",
+			"integrity": "sha512-D6bTRWh6KahHTK/m4WnjPQyEinNPf9eFLEZSEoj7d6fTibspnAVYfzHvirL7u/aoX5d9YYfIkBVAhmigUELk9w==",
+			"license": "MIT",
+			"dependencies": {
+				"eventsource-parser": "^3.0.1"
+			},
+			"engines": {
+				"node": ">=20.0.0"
+			}
+		},
+		"node_modules/eventsource-parser": {
+			"version": "3.1.1",
+			"resolved": "https://registry.npmjs.org/eventsource-parser/-/eventsource-parser-3.1.1.tgz",
+			"integrity": "sha512-EKN1vKAMcZ8MlYMpaNuxN6R9yakzH6uajHcHVTqWJzvu5pWw9DyhbP35HH8MVBQ+dZjAfDxk+A8NiR9KWaXiyQ==",
+			"license": "MIT",
+			"engines": {
+				"node": ">=18.0.0"
+			}
+		},
 		"node_modules/expect": {
 			"version": "30.4.1",
 			"resolved": "https://registry.npmjs.org/expect/-/expect-30.4.1.tgz",
@@ -3864,6 +3980,15 @@
 				}
 			}
 		},
+		"node_modules/feaxios": {
+			"version": "0.0.23",
+			"resolved": "https://registry.npmjs.org/feaxios/-/feaxios-0.0.23.tgz",
+			"integrity": "sha512-eghR0A21fvbkcQBgZuMfQhrXxJzC0GNUGC9fXhBge33D+mFDTwl0aJ35zoQQn575BhyjQitRc5N4f+L4cP708g==",
+			"license": "MIT",
+			"dependencies": {
+				"is-retry-allowed": "^3.0.0"
+			}
+		},
 		"node_modules/file-entry-cache": {
 			"version": "8.0.0",
 			"resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
@@ -3928,11 +4053,30 @@
 			"dev": true,
 			"license": "ISC"
 		},
+		"node_modules/follow-redirects": {
+			"version": "1.16.1",
+			"resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.1.tgz",
+			"integrity": "sha512-FNvFGzoMLWmE6Yj9spb/zjd7yiNCHiAW9/Tg9CXrQ8wuu32HtlJOwWO11OJafl5FfY3DxTdQ0vj42zU1kvv5jg==",
+			"funding": [
+				{
+					"type": "individual",
+					"url": "https://github.com/sponsors/RubenVerborgh"
+				}
+			],
+			"license": "MIT",
+			"engines": {
+				"node": ">=4.0"
+			},
+			"peerDependenciesMeta": {
+				"debug": {
+					"optional": true
+				}
+			}
+		},
 		"node_modules/form-data": {
 			"version": "4.0.6",
 			"resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.6.tgz",
 			"integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==",
-			"dev": true,
 			"dependencies": {
 				"asynckit": "^0.4.0",
 				"combined-stream": "^1.0.8",
@@ -3977,7 +4121,6 @@
 			"version": "1.1.2",
 			"resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
 			"integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-			"dev": true,
 			"funding": {
 				"url": "https://github.com/sponsors/ljharb"
 			}
@@ -3995,7 +4138,6 @@
 			"version": "1.3.0",
 			"resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
 			"integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
-			"dev": true,
 			"dependencies": {
 				"call-bind-apply-helpers": "^1.0.2",
 				"es-define-property": "^1.0.1",
@@ -4019,7 +4161,6 @@
 			"version": "1.0.1",
 			"resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
 			"integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
-			"dev": true,
 			"dependencies": {
 				"dunder-proto": "^1.0.1",
 				"es-object-atoms": "^1.0.0"
@@ -4058,7 +4199,6 @@
 			"version": "1.2.0",
 			"resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
 			"integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
-			"dev": true,
 			"engines": {
 				"node": ">= 0.4"
 			},
@@ -4087,7 +4227,6 @@
 			"version": "1.1.0",
 			"resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
 			"integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
-			"dev": true,
 			"engines": {
 				"node": ">= 0.4"
 			},
@@ -4099,7 +4238,6 @@
 			"version": "1.0.2",
 			"resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
 			"integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
-			"dev": true,
 			"dependencies": {
 				"has-symbols": "^1.0.3"
 			},
@@ -4114,7 +4252,6 @@
 			"version": "2.0.4",
 			"resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz",
 			"integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
-			"dev": true,
 			"dependencies": {
 				"function-bind": "^1.1.2"
 			},
@@ -4336,6 +4473,18 @@
 			"integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==",
 			"dev": true
 		},
+		"node_modules/is-retry-allowed": {
+			"version": "3.0.0",
+			"resolved": "https://registry.npmjs.org/is-retry-allowed/-/is-retry-allowed-3.0.0.tgz",
+			"integrity": "sha512-9xH0xvoggby+u0uGF7cZXdrutWiBiaFG8ZT4YFPXL8NzkyAwX3AKGLeFQLvzDpM430+nDFBZ1LHkie/8ocL06A==",
+			"license": "MIT",
+			"engines": {
+				"node": ">=12"
+			},
+			"funding": {
+				"url": "https://github.com/sponsors/sindresorhus"
+			}
+		},
 		"node_modules/isexe": {
 			"version": "2.0.0",
 			"resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
@@ -4919,7 +5068,6 @@
 			"version": "1.1.0",
 			"resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
 			"integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
-			"dev": true,
 			"engines": {
 				"node": ">= 0.4"
 			}
@@ -4965,7 +5113,6 @@
 			"version": "1.52.0",
 			"resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
 			"integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
-			"dev": true,
 			"engines": {
 				"node": ">= 0.6"
 			}
@@ -4974,7 +5121,6 @@
 			"version": "2.1.35",
 			"resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
 			"integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
-			"dev": true,
 			"dependencies": {
 				"mime-db": "1.52.0"
 			},
@@ -5012,7 +5158,6 @@
 			"version": "2.1.3",
 			"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
 			"integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-			"dev": true,
 			"license": "MIT"
 		},
 		"node_modules/mz": {
@@ -5462,6 +5607,15 @@
 				"url": "https://github.com/chalk/ansi-styles?sponsor=1"
 			}
 		},
+		"node_modules/proxy-from-env": {
+			"version": "2.1.0",
+			"resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-2.1.0.tgz",
+			"integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==",
+			"license": "MIT",
+			"engines": {
+				"node": ">=10"
+			}
+		},
 		"node_modules/psl": {
 			"version": "1.15.0",
 			"resolved": "https://registry.npmjs.org/psl/-/psl-1.15.0.tgz",
@@ -5917,6 +6071,18 @@
 				"node": ">=8"
 			}
 		},
+		"node_modules/smol-toml": {
+			"version": "1.9.1",
+			"resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.9.1.tgz",
+			"integrity": "sha512-j7WyPdf0CJoutMzMoPLF/bVXHtKZIT9Rb4eGeEbWw8X2t5oirjPgpL+OpaENZrILYaXqYwnVH+qgUwVbl+pUJQ==",
+			"license": "BSD-3-Clause",
+			"engines": {
+				"node": ">= 18"
+			},
+			"funding": {
+				"url": "https://github.com/sponsors/cyyynthia"
+			}
+		},
 		"node_modules/source-map-js": {
 			"version": "1.2.2",
 			"resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.2.tgz",
@@ -6280,6 +6446,18 @@
 				"node": ">=14.17"
 			}
 		},
+		"node_modules/uint8array-extras": {
+			"version": "1.6.0",
+			"resolved": "https://registry.npmjs.org/uint8array-extras/-/uint8array-extras-1.6.0.tgz",
+			"integrity": "sha512-8iAasVS4wUx0gPLjH8Xtz2PeDzTSiy8QiLGu2DT3X5GU+egFEQhpnbtkehbAwjvDcxIERmCYcysiODFmE3Ud0Q==",
+			"license": "MIT",
+			"engines": {
+				"node": ">=18"
+			},
+			"funding": {
+				"url": "https://github.com/sponsors/sindresorhus"
+			}
+		},
 		"node_modules/undici-types": {
 			"version": "8.3.0",
 			"resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.3.0.tgz",
diff --git a/package.json b/package.json
index 53ec33c..0b9538a 100644
--- a/package.json
+++ b/package.json
@@ -12,7 +12,7 @@
 	},
 	"dependencies": {
 		"@hookform/resolvers": "^5.9.1",
-		"@stellar/freighter-api": "^6.0.1",
+		"@stellar/stellar-sdk": "^17.2.1",
 		"html2canvas": "^1.4.1",
 		"lucide-react": "^1.7.0",
 		"qrcode": "^1.5.1",
diff --git a/src/App.tsx b/src/App.tsx
index 32ec1ce..a041a96 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -20,14 +20,25 @@ import { GovernanceProposalCreatePage } from "./pages/GovernanceProposalCreatePa
 import { AdminAlertsInbox } from "./pages/AdminAlertsInbox";
 import { PayoutSchedule } from "./pages/PayoutSchedule";
 import { GovernanceVoteReceiptDemo } from "./pages/GovernanceVoteReceiptDemo";
+import { useContractRead } from "./hooks/useContractRead";
+import { getContractSummary } from "./lib/soroban/revoraContract";
+import {
+  CONTRACT_ID,
+  buildContractExplorerUrl,
+  buildStellarLabUrl,
+} from "./constants/stellar";
 
 const LIVE_URL = "https://revora-frontend-omega.vercel.app";
 const REPO_URL = "https://github.com/RevoraOrg/Revora-Frontend";
-const CONTRACT_ID = "CABIJLQV4TKBHMETNIISV4OT76EDR5WXCZVJJLXHA6AEIII2JVYAHP2I";
-const STELLAR_LAB_URL = `https://lab.stellar.org/r/testnet/contract/${CONTRACT_ID}`;
-const STELLAR_EXPERT_URL = `https://stellar.expert/explorer/testnet/contract/${CONTRACT_ID}`;
+const STELLAR_LAB_URL = buildStellarLabUrl();
+const STELLAR_EXPERT_URL = buildContractExplorerUrl();
 
 function SiteFooter() {
+  const { data: contractSummary, isLoading, isError, error, retry } = useContractRead(
+    getContractSummary,
+    { retryCount: 2, retryDelay: 1000 },
+  );
+
   return (
     <footer className="site-footer">
       <div className="site-footer__row">
@@ -37,6 +48,39 @@ function SiteFooter() {
         </span>
       </div>
       <code className="site-footer__contract">{CONTRACT_ID}</code>
+      
+      {/* On-chain status panel */}
+      <div className="site-footer__status">
+        {isLoading && (
+          <div className="site-footer__status-loading">
+            <span className="text-muted">Loading contract data...</span>
+          </div>
+        )}
+        {isError && (
+          <div className="site-footer__status-error">
+            <span className="text-muted" style={{ color: '#ef4444' }}>
+              Failed to load contract data: {error}
+            </span>
+            <button
+              type="button"
+              onClick={retry}
+              className="link-styled"
+              style={{ background: 'none', border: 'none', padding: 0, marginLeft: '0.5rem', cursor: 'pointer' }}
+            >
+              Retry
+            </button>
+          </div>
+        )}
+        {contractSummary && !isLoading && (
+          <div className="site-footer__status-success">
+            <span className="text-muted">
+              {contractSummary.periodCount} period{contractSummary.periodCount !== 1 ? 's' : ''} registered, 
+              {contractSummary.authorizedOfferingsCount} authorized offering{contractSummary.authorizedOfferingsCount !== 1 ? 's' : ''}
+            </span>
+          </div>
+        )}
+      </div>
+      
       <div className="site-footer__row">
         <a href={STELLAR_EXPERT_URL} className="link-styled" target="_blank" rel="noopener noreferrer">Stellar Expert</a>
         <a href={STELLAR_LAB_URL} className="link-styled" target="_blank" rel="noopener noreferrer">Stellar Lab</a>
diff --git a/src/constants/stellar.test.ts b/src/constants/stellar.test.ts
new file mode 100644
index 0000000..8f4ab06
--- /dev/null
+++ b/src/constants/stellar.test.ts
@@ -0,0 +1,66 @@
+/**
+ * Unit tests for Stellar network configuration
+ */
+
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import {
+  DEFAULT_NETWORK,
+  DEFAULT_NETWORK_PASSPHRASE,
+  DEFAULT_RPC_URL,
+  DEFAULT_CONTRACT_ID,
+  DEFAULT_EXPLORER_BASE,
+  DEFAULT_STELLAR_LAB_BASE,
+  NETWORK,
+  NETWORK_PASSPHRASE,
+  RPC_URL,
+  CONTRACT_ID,
+  EXPLORER_BASE,
+  STELLAR_LAB_BASE,
+  buildContractExplorerUrl,
+  buildStellarLabUrl,
+  buildTransactionExplorerUrl,
+} from './stellar';
+
+describe('stellar constants', () => {
+  beforeEach(() => {
+    // Reset import.meta.env before each test
+    vi.stubGlobal('import.meta.env', {});
+  });
+
+  it('has correct default values', () => {
+    expect(DEFAULT_NETWORK).toBe('TESTNET');
+    expect(DEFAULT_NETWORK_PASSPHRASE).toBeDefined();
+    expect(DEFAULT_RPC_URL).toBe('https://soroban-testnet.stellar.org');
+    expect(DEFAULT_CONTRACT_ID).toBe('CABIJLQV4TKBHMETNIISV4OT76EDR5WXCZVJJLXHA6AEIII2JVYAHP2I');
+    expect(DEFAULT_EXPLORER_BASE).toBe('https://stellar.expert/explorer/testnet');
+    expect(DEFAULT_STELLAR_LAB_BASE).toBe('https://lab.stellar.org/r/testnet');
+  });
+
+  it('uses defaults when no env vars are set', () => {
+    expect(NETWORK).toBe(DEFAULT_NETWORK);
+    expect(NETWORK_PASSPHRASE).toBe(DEFAULT_NETWORK_PASSPHRASE);
+    expect(RPC_URL).toBe(DEFAULT_RPC_URL);
+    expect(CONTRACT_ID).toBe(DEFAULT_CONTRACT_ID);
+    expect(EXPLORER_BASE).toBe(DEFAULT_EXPLORER_BASE);
+    expect(STELLAR_LAB_BASE).toBe(DEFAULT_STELLAR_LAB_BASE);
+  });
+
+  it('builds contract explorer URLs', () => {
+    const url = buildContractExplorerUrl();
+    expect(url).toBe(`${DEFAULT_EXPLORER_BASE}/contract/${DEFAULT_CONTRACT_ID}`);
+    
+    const customUrl = buildContractExplorerUrl('CXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX');
+    expect(customUrl).toBe(`${DEFAULT_EXPLORER_BASE}/contract/CXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX`);
+  });
+
+  it('builds Stellar Lab URLs', () => {
+    const url = buildStellarLabUrl();
+    expect(url).toBe(`${DEFAULT_STELLAR_LAB_BASE}/contract/${DEFAULT_CONTRACT_ID}`);
+  });
+
+  it('builds transaction explorer URLs', () => {
+    const txHash = 'abc123';
+    const url = buildTransactionExplorerUrl(txHash);
+    expect(url).toBe(`${DEFAULT_EXPLORER_BASE}/tx/${txHash}`);
+  });
+});
diff --git a/src/constants/stellar.ts b/src/constants/stellar.ts
new file mode 100644
index 0000000..bc5df53
--- /dev/null
+++ b/src/constants/stellar.ts
@@ -0,0 +1,124 @@
+/**
+ * Stellar Network Configuration — Soroban RPC & Contract Constants
+ *
+ * Defines network endpoints, contract IDs, and explorer URLs for the
+ * Revora revenue-deposit contract on Stellar testnet.
+ */
+
+import { Networks } from '@stellar/stellar-sdk';
+
+export type NetworkType = 'TESTNET' | 'PUBLIC';
+
+export const DEFAULT_NETWORK: NetworkType = 'TESTNET';
+export const DEFAULT_NETWORK_PASSPHRASE = Networks.TESTNET;
+export const DEFAULT_RPC_URL = 'https://soroban-testnet.stellar.org';
+export const DEFAULT_CONTRACT_ID = 'CABIJLQV4TKBHMETNIISV4OT76EDR5WXCZVJJLXHA6AEIII2JVYAHP2I';
+export const DEFAULT_EXPLORER_BASE = 'https://stellar.expert/explorer/testnet';
+export const DEFAULT_STELLAR_LAB_BASE = 'https://lab.stellar.org/r/testnet';
+
+/**
+ * Validates that a string is a valid Stellar contract ID (starts with 'C' and is 56 chars)
+ */
+function isValidContractId(id: string): boolean {
+  return typeof id === 'string' && id.length === 56 && id.startsWith('C');
+}
+
+/**
+ * Validates that a URL string is a valid HTTPS URL
+ */
+function isValidHttpsUrl(url: string): boolean {
+  try {
+    const parsed = new URL(url);
+    return parsed.protocol === 'https:';
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Validates network type
+ */
+function isValidNetwork(network: string): network is NetworkType {
+  return network === 'TESTNET' || network === 'PUBLIC';
+}
+
+/**
+ * Reads an environment variable with validation and fallback to default.
+ * Logs an error to console and falls back to default if validation fails.
+ */
+function getEnvVarWithFallback<T>(
+  envVarName: string,
+  defaultValue: T,
+  validator: (value: string) => boolean,
+): T {
+  const envValue = import.meta.env[envVarName];
+  
+  if (envValue === undefined || envValue === '') {
+    return defaultValue;
+  }
+
+  if (!validator(envValue)) {
+    console.error(
+      `[Stellar Config] Invalid ${envVarName}: "${envValue}". Falling back to default:`,
+      defaultValue,
+    );
+    return defaultValue;
+  }
+
+  return envValue as T;
+}
+
+/**
+ * Network configuration with environment variable overrides.
+ * Override with VITE_STELLAR_NETWORK, VITE_STELLAR_RPC_URL, etc.
+ */
+export const NETWORK = getEnvVarWithFallback(
+  'VITE_STELLAR_NETWORK',
+  DEFAULT_NETWORK,
+  isValidNetwork,
+);
+
+export const NETWORK_PASSPHRASE = getEnvVarWithFallback(
+  'VITE_STELLAR_NETWORK_PASSPHRASE',
+  DEFAULT_NETWORK_PASSPHRASE,
+  () => true, // Network passphrase can be any string
+);
+
+export const RPC_URL = getEnvVarWithFallback(
+  'VITE_STELLAR_RPC_URL',
+  DEFAULT_RPC_URL,
+  isValidHttpsUrl,
+);
+
+export const CONTRACT_ID = getEnvVarWithFallback(
+  'VITE_STELLAR_CONTRACT_ID',
+  DEFAULT_CONTRACT_ID,
+  isValidContractId,
+);
+
+export const EXPLORER_BASE = getEnvVarWithFallback(
+  'VITE_STELLAR_EXPLORER_BASE',
+  DEFAULT_EXPLORER_BASE,
+  isValidHttpsUrl,
+);
+
+export const STELLAR_LAB_BASE = getEnvVarWithFallback(
+  'VITE_STELLAR_LAB_BASE',
+  DEFAULT_STELLAR_LAB_BASE,
+  isValidHttpsUrl,
+);
+
+/**
+ * Helper to build explorer URLs for contracts and transactions
+ */
+export function buildContractExplorerUrl(contractId: string = CONTRACT_ID): string {
+  return `${EXPLORER_BASE}/contract/${contractId}`;
+}
+
+export function buildStellarLabUrl(contractId: string = CONTRACT_ID): string {
+  return `${STELLAR_LAB_BASE}/contract/${contractId}`;
+}
+
+export function buildTransactionExplorerUrl(txHash: string): string {
+  return `${EXPLORER_BASE}/tx/${txHash}`;
+}
diff --git a/src/hooks/useContractRead.test.ts b/src/hooks/useContractRead.test.ts
new file mode 100644
index 0000000..292b938
--- /dev/null
+++ b/src/hooks/useContractRead.test.ts
@@ -0,0 +1,177 @@
+/**
+ * Unit tests for useContractRead hook
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { renderHook, waitFor, act } from '@testing-library/react';
+import { useContractRead } from './useContractRead';
+
+describe('useContractRead', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('initially returns loading state and null data', () => {
+    const fetchFn = vi.fn(() => Promise.resolve('data'));
+    const { result } = renderHook(() => useContractRead(fetchFn));
+
+    expect(result.current.isLoading).toBe(true);
+    expect(result.current.data).toBe(null);
+    expect(result.current.isError).toBe(false);
+    expect(result.current.error).toBe(null);
+  });
+
+  it('successfully fetches data', async () => {
+    const mockData = { value: 123 };
+    const fetchFn = vi.fn(() => Promise.resolve(mockData));
+    const { result } = renderHook(() => useContractRead(fetchFn));
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+
+    expect(result.current.data).toEqual(mockData);
+    expect(result.current.isError).toBe(false);
+    expect(result.current.error).toBe(null);
+    expect(fetchFn).toHaveBeenCalledTimes(1);
+  });
+
+  it('handles fetch errors', async () => {
+    const errorMessage = 'Network error';
+    const fetchFn = vi.fn(() => Promise.reject(new Error(errorMessage)));
+    const { result } = renderHook(() => useContractRead(fetchFn));
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+
+    expect(result.current.data).toBe(null);
+    expect(result.current.isError).toBe(true);
+    expect(result.current.error).toBe(errorMessage);
+  });
+
+  it('does not auto-fetch when disabled', async () => {
+    const fetchFn = vi.fn(() => Promise.resolve('data'));
+    const { result } = renderHook(() => useContractRead(fetchFn, { enabled: false }));
+
+    // Wait a bit to ensure no fetch happened
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    }, { timeout: 100 });
+
+    expect(fetchFn).not.toHaveBeenCalled();
+    expect(result.current.data).toBe(null);
+  });
+
+  it('retries on failure with default retry count', async () => {
+    const fetchFn = vi.fn()
+      .mockRejectedValueOnce(new Error('Error 1'))
+      .mockRejectedValueOnce(new Error('Error 2'))
+      .mockRejectedValueOnce(new Error('Error 3'))
+      .mockResolvedValueOnce('success');
+
+    const { result } = renderHook(() => useContractRead(fetchFn, { retryCount: 3, retryDelay: 10 }));
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    }, { timeout: 1000 });
+
+    expect(fetchFn).toHaveBeenCalledTimes(4); // initial + 3 retries
+    expect(result.current.data).toBe('success');
+    expect(result.current.isError).toBe(false);
+  });
+
+  it('stops retrying after max retry count', async () => {
+    const fetchFn = vi.fn(() => Promise.reject(new Error('Persistent error')));
+    const { result } = renderHook(() => useContractRead(fetchFn, { retryCount: 2, retryDelay: 10 }));
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    }, { timeout: 100 });
+
+    expect(fetchFn).toHaveBeenCalledTimes(3); // initial + 2 retries
+    expect(result.current.isError).toBe(true);
+    expect(result.current.error).toBe('Persistent error');
+  });
+
+  it('manual retry function works', async () => {
+    let shouldFail = true;
+    const fetchFn = vi.fn(() => {
+      if (shouldFail) {
+        return Promise.reject(new Error('First failure'));
+      }
+      return Promise.resolve('success');
+    });
+
+    const { result } = renderHook(() => useContractRead(fetchFn, { retryCount: 0 }));
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+
+    expect(result.current.isError).toBe(true);
+
+    act(() => {
+      shouldFail = false;
+      result.current.retry();
+    });
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+
+    expect(result.current.data).toBe('success');
+    expect(result.current.isError).toBe(false);
+  });
+
+  it('manual refetch function works', async () => {
+    const fetchFn = vi.fn(() => Promise.resolve('data'));
+    const { result } = renderHook(() => useContractRead(fetchFn));
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+
+    expect(fetchFn).toHaveBeenCalledTimes(1);
+
+    act(() => {
+      result.current.refetch();
+    });
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+
+    expect(fetchFn).toHaveBeenCalledTimes(2);
+  });
+
+  it('cancels in-flight request on unmount', async () => {
+    const fetchFn = vi.fn(() => new Promise((resolve) => setTimeout(() => resolve('data'), 1000)));
+    const { result, unmount } = renderHook(() => useContractRead(fetchFn));
+
+    expect(result.current.isLoading).toBe(true);
+
+    unmount();
+
+    // The request should be aborted, but we can't easily test that directly
+    // At minimum, verify no errors are thrown during unmount
+    expect(result.current.isLoading).toBe(true);
+  });
+
+  it('respects custom retry delay', async () => {
+    const fetchFn = vi.fn()
+      .mockRejectedValueOnce(new Error('Error 1'))
+      .mockResolvedValueOnce('success');
+
+    const startTime = Date.now();
+    const { result } = renderHook(() => useContractRead(fetchFn, { retryCount: 1, retryDelay: 100 }));
+
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    }, { timeout: 500 });
+
+    const elapsed = Date.now() - startTime;
+    expect(elapsed).toBeGreaterThanOrEqual(100);
+    expect(fetchFn).toHaveBeenCalledTimes(2);
+  });
+});
diff --git a/src/hooks/useContractRead.ts b/src/hooks/useContractRead.ts
new file mode 100644
index 0000000..078dd09
--- /dev/null
+++ b/src/hooks/useContractRead.ts
@@ -0,0 +1,128 @@
+/**
+ * React hook for read-only contract calls with loading, error, and retry states
+ *
+ * Provides a generic hook for fetching contract data with automatic retry logic,
+ * loading states, and error handling. Designed for Soroban read-only queries.
+ */
+
+import { useState, useEffect, useCallback, useRef } from 'react';
+
+export interface UseContractReadOptions {
+  /** Whether to automatically fetch on mount (default: true) */
+  enabled?: boolean;
+  /** Number of retry attempts on failure (default: 3) */
+  retryCount?: number;
+  /** Delay between retries in ms (default: 1000) */
+  retryDelay?: number;
+}
+
+export interface UseContractReadResult<T> {
+  /** The fetched data */
+  data: T | null;
+  /** Whether a fetch is in progress */
+  isLoading: boolean;
+  /** Whether the last fetch resulted in an error */
+  isError: boolean;
+  /** The error message if isError is true */
+  error: string | null;
+  /** Retry the last failed fetch */
+  retry: () => void;
+  /** Manually trigger a fetch */
+  refetch: () => void;
+}
+
+/**
+ * Generic hook for read-only contract data fetching
+ *
+ * @param fetchFn - Async function that returns the data
+ * @param options - Configuration options
+ * @returns Object with data, loading state, error state, and retry/refetch functions
+ */
+export function useContractRead<T>(
+  fetchFn: () => Promise<T>,
+  options: UseContractReadOptions = {},
+): UseContractReadResult<T> {
+  const {
+    enabled = true,
+    retryCount = 3,
+    retryDelay = 1000,
+  } = options;
+
+  const [data, setData] = useState<T | null>(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [isError, setIsError] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  // Track retry attempts
+  const retryAttempts = useRef(0);
+  const abortController = useRef<AbortController | null>(null);
+
+  const fetchData = useCallback(async (isRetry = false) => {
+    // Cancel any in-flight request
+    if (abortController.current) {
+      abortController.current.abort();
+    }
+
+    // Create new abort controller for this request
+    abortController.current = new AbortController();
+
+    setIsLoading(true);
+    setIsError(false);
+    setError(null);
+
+    try {
+      const result = await fetchFn();
+      setData(result);
+      setIsLoading(false);
+      retryAttempts.current = 0; // Reset retry counter on success
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : String(err);
+      setError(errorMessage);
+      setIsError(true);
+      setIsLoading(false);
+
+      // Automatic retry logic
+      if (!isRetry && retryAttempts.current < retryCount) {
+        retryAttempts.current += 1;
+        setTimeout(() => {
+          fetchData(true);
+        }, retryDelay);
+      }
+    }
+  }, [fetchFn, retryCount, retryDelay]);
+
+  // Manual retry function
+  const retry = useCallback(() => {
+    retryAttempts.current = 0;
+    fetchData();
+  }, [fetchData]);
+
+  // Manual refetch function
+  const refetch = useCallback(() => {
+    retryAttempts.current = 0;
+    fetchData();
+  }, [fetchData]);
+
+  // Auto-fetch on mount if enabled
+  useEffect(() => {
+    if (enabled) {
+      fetchData();
+    }
+
+    // Cleanup on unmount
+    return () => {
+      if (abortController.current) {
+        abortController.current.abort();
+      }
+    };
+  }, [enabled, fetchData]);
+
+  return {
+    data,
+    isLoading,
+    isError,
+    error,
+    retry,
+    refetch,
+  };
+}
diff --git a/src/index.css b/src/index.css
index e90dc61..adf97c1 100644
--- a/src/index.css
+++ b/src/index.css
@@ -1277,3 +1277,18 @@ html, body { overflow-x: clip; }
 }
 .site-footer__row { display: flex; flex-wrap: wrap; gap: 0.25rem 1rem; justify-content: center; }
 .site-footer__contract { max-width: 100%; overflow-wrap: anywhere; font-size: 0.75rem; color: var(--text-main); }
+.site-footer__status {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  font-size: 0.75rem;
+  min-height: 1.25rem;
+}
+.site-footer__status-loading,
+.site-footer__status-error,
+.site-footer__status-success {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
diff --git a/src/lib/soroban/revoraContract.test.ts b/src/lib/soroban/revoraContract.test.ts
new file mode 100644
index 0000000..a4ef3f3
--- /dev/null
+++ b/src/lib/soroban/revoraContract.test.ts
@@ -0,0 +1,278 @@
+/**
+ * Unit tests for revoraContract.ts
+ * Tests the read-only Soroban client with mocked rpc.Server
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { rpc } from '@stellar/stellar-sdk';
+import {
+  CONTRACT_METHODS,
+  getAdmin,
+  getToken,
+  getPeriodIds,
+  getPeriod,
+  hasClaimed,
+  getBeneficiaries,
+  getUnclaimedSummary,
+  getAuthorizedOfferings,
+  getContractSummary,
+  type Period,
+} from './revoraContract';
+
+// Mock the stellar-sdk RPC Server
+vi.mock('@stellar/stellar-sdk', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('@stellar/stellar-sdk')>();
+  return {
+    ...actual,
+    rpc: {
+      ...actual.rpc,
+      Server: class MockServer {
+        queryContract: ReturnType<typeof vi.fn>;
+        constructor(url: string) {
+          this.queryContract = vi.fn();
+        }
+      },
+    },
+  };
+});
+
+describe('revoraContract', () => {
+  let mockServer: InstanceType<ReturnType<typeof rpc.Server>>;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockServer = new rpc.Server('https://test.rpc');
+  });
+
+  describe('CONTRACT_METHODS', () => {
+    it('contains all expected method names', () => {
+      expect(CONTRACT_METHODS.GET_ADMIN).toBe('get_admin');
+      expect(CONTRACT_METHODS.GET_TOKEN).toBe('get_token');
+      expect(CONTRACT_METHODS.GET_PERIOD).toBe('get_period');
+      expect(CONTRACT_METHODS.GET_PERIOD_IDS).toBe('get_period_ids');
+      expect(CONTRACT_METHODS.HAS_CLAIMED).toBe('has_claimed');
+      expect(CONTRACT_METHODS.GET_BENEFICIARIES).toBe('get_beneficiaries');
+      expect(CONTRACT_METHODS.UNCLAIMED_SUMMARY).toBe('unclaimed_summary');
+      expect(CONTRACT_METHODS.GET_AUTHORIZED_OFFERINGS).toBe('get_authorized_offerings');
+    });
+  });
+
+  describe('getAdmin', () => {
+    it('successfully queries admin address', async () => {
+      const adminAddress = 'GXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
+      mockServer.queryContract.mockResolvedValue({ result: adminAddress, isReadCall: true });
+
+      const result = await getAdmin();
+
+      expect(mockServer.queryContract).toHaveBeenCalledWith(
+        expect.any(String),
+        CONTRACT_METHODS.GET_ADMIN,
+        undefined,
+        expect.any(String),
+      );
+      expect(result).toBe(adminAddress);
+    });
+
+    it('propagates errors from RPC call', async () => {
+      const error = new Error('Network error');
+      mockServer.queryContract.mockRejectedValue(error);
+
+      await expect(getAdmin()).rejects.toThrow('Network error');
+    });
+  });
+
+  describe('getToken', () => {
+    it('successfully queries token address', async () => {
+      const tokenAddress = 'CXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
+      mockServer.queryContract.mockResolvedValue({ result: tokenAddress, isReadCall: true });
+
+      const result = await getToken();
+
+      expect(mockServer.queryContract).toHaveBeenCalledWith(
+        expect.any(String),
+        CONTRACT_METHODS.GET_TOKEN,
+        undefined,
+        expect.any(String),
+      );
+      expect(result).toBe(tokenAddress);
+    });
+  });
+
+  describe('getPeriodIds', () => {
+    it('successfully queries period IDs', async () => {
+      const periodIds = [1, 2, 3];
+      mockServer.queryContract.mockResolvedValue({ result: periodIds, isReadCall: true });
+
+      const result = await getPeriodIds();
+
+      expect(mockServer.queryContract).toHaveBeenCalledWith(
+        expect.any(String),
+        CONTRACT_METHODS.GET_PERIOD_IDS,
+        undefined,
+        expect.any(String),
+      );
+      expect(result).toEqual(periodIds);
+    });
+  });
+
+  describe('getPeriod', () => {
+    it('successfully queries period metadata', async () => {
+      const period: Period = {
+        start_ledger: 1000,
+        end_ledger: 2000,
+        revenue_amount: BigInt(1000000),
+        is_complete: true,
+      };
+      mockServer.queryContract.mockResolvedValue({ result: period, isReadCall: true });
+
+      const result = await getPeriod(1);
+
+      expect(mockServer.queryContract).toHaveBeenCalledWith(
+        expect.any(String),
+        CONTRACT_METHODS.GET_PERIOD,
+        { period_id: 1 },
+        expect.any(String),
+      );
+      expect(result).toEqual(period);
+    });
+
+    it('returns null on simulation error', async () => {
+      const error = new Error('Period not found');
+      mockServer.queryContract.mockRejectedValue(error);
+
+      const result = await getPeriod(999);
+
+      expect(result).toBeNull();
+    });
+
+    it('returns null on network error', async () => {
+      const error = new Error('RPC timeout');
+      mockServer.queryContract.mockRejectedValue(error);
+
+      const result = await getPeriod(1);
+
+      expect(result).toBeNull();
+    });
+  });
+
+  describe('hasClaimed', () => {
+    it('successfully queries claim status', async () => {
+      mockServer.queryContract.mockResolvedValue({ result: true, isReadCall: true });
+
+      const result = await hasClaimed(1, 'GXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX');
+
+      expect(mockServer.queryContract).toHaveBeenCalledWith(
+        expect.any(String),
+        CONTRACT_METHODS.HAS_CLAIMED,
+        { period_id: 1, address: 'GXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' },
+        expect.any(String),
+      );
+      expect(result).toBe(true);
+    });
+  });
+
+  describe('getBeneficiaries', () => {
+    it('successfully queries beneficiary list', async () => {
+      const beneficiaries = ['GXXX1', 'GXXX2', 'GXXX3'];
+      mockServer.queryContract.mockResolvedValue({ result: beneficiaries, isReadCall: true });
+
+      const result = await getBeneficiaries(1);
+
+      expect(mockServer.queryContract).toHaveBeenCalledWith(
+        expect.any(String),
+        CONTRACT_METHODS.GET_BENEFICIARIES,
+        { period_id: 1 },
+        expect.any(String),
+      );
+      expect(result).toEqual(beneficiaries);
+    });
+
+    it('returns null on error', async () => {
+      const error = new Error('Period not found');
+      mockServer.queryContract.mockRejectedValue(error);
+
+      const result = await getBeneficiaries(999);
+
+      expect(result).toBeNull();
+    });
+  });
+
+  describe('getUnclaimedSummary', () => {
+    it('successfully queries unclaimed summary', async () => {
+      const summary = {
+        1: BigInt(500000),
+        2: BigInt(300000),
+      };
+      mockServer.queryContract.mockResolvedValue({ result: summary, isReadCall: true });
+
+      const result = await getUnclaimedSummary();
+
+      expect(mockServer.queryContract).toHaveBeenCalledWith(
+        expect.any(String),
+        CONTRACT_METHODS.UNCLAIMED_SUMMARY,
+        undefined,
+        expect.any(String),
+      );
+      expect(result).toEqual([
+        { period_id: 1, amount: BigInt(500000) },
+        { period_id: 2, amount: BigInt(300000) },
+      ]);
+    });
+  });
+
+  describe('getAuthorizedOfferings', () => {
+    it('successfully queries authorized offerings', async () => {
+      const offerings = ['CXXX1', 'CXXX2'];
+      mockServer.queryContract.mockResolvedValue({ result: offerings, isReadCall: true });
+
+      const result = await getAuthorizedOfferings();
+
+      expect(mockServer.queryContract).toHaveBeenCalledWith(
+        expect.any(String),
+        CONTRACT_METHODS.GET_AUTHORIZED_OFFERINGS,
+        undefined,
+        expect.any(String),
+      );
+      expect(result).toEqual(offerings);
+    });
+  });
+
+  describe('getContractSummary', () => {
+    it('successfully fetches complete contract summary', async () => {
+      const admin = 'GADMIN';
+      const token = 'CTOKEN';
+      const periodIds = [1, 2, 3];
+      const authorizedOfferings = ['COFFERING1', 'COFFERING2'];
+
+      mockServer.queryContract
+        .mockResolvedValueOnce({ result: admin, isReadCall: true })
+        .mockResolvedValueOnce({ result: token, isReadCall: true })
+        .mockResolvedValueOnce({ result: periodIds, isReadCall: true })
+        .mockResolvedValueOnce({ result: authorizedOfferings, isReadCall: true });
+
+      const result = await getContractSummary();
+
+      expect(result).toEqual({
+        admin,
+        token,
+        periodCount: 3,
+        periodIds,
+        authorizedOfferingsCount: 2,
+      });
+    });
+
+    it('propagates errors from RPC calls', async () => {
+      mockServer.queryContract.mockRejectedValue(new Error('Network failure'));
+
+      await expect(getContractSummary()).rejects.toThrow('Failed to fetch contract summary');
+    });
+
+    it('handles partial failures gracefully', async () => {
+      mockServer.queryContract
+        .mockResolvedValueOnce({ result: 'GADMIN', isReadCall: true })
+        .mockRejectedValueOnce(new Error('Token query failed'));
+
+      await expect(getContractSummary()).rejects.toThrow('Failed to fetch contract summary');
+    });
+  });
+});
diff --git a/src/lib/soroban/revoraContract.ts b/src/lib/soroban/revoraContract.ts
new file mode 100644
index 0000000..ebd4060
--- /dev/null
+++ b/src/lib/soroban/revoraContract.ts
@@ -0,0 +1,226 @@
+/**
+ * Read-only Soroban client for the Revora revenue-deposit contract
+ *
+ * Provides typed functions to query contract state without signing transactions.
+ * Uses @stellar/stellar-sdk rpc.Server for read-only contract calls.
+ *
+ * Contract methods (from getContractMethods):
+ * - get_admin(): Address
+ * - get_token(): Address
+ * - get_period(period_id: U32): Result<Period>
+ * - get_period_ids(): Vec<U32>
+ * - has_claimed(period_id: U32, address: Address): Bool
+ * - get_beneficiaries(period_id: U32): Result<Vec<Address>>
+ * - unclaimed_summary(): Map<U32, I128>
+ * - get_authorized_offerings(): Vec<Address>
+ */
+
+import { rpc } from '@stellar/stellar-sdk';
+import {
+  RPC_URL,
+  NETWORK_PASSPHRASE,
+  CONTRACT_ID,
+} from '../../constants/stellar';
+
+/**
+ * Contract method names (recorded from contract interface)
+ */
+export const CONTRACT_METHODS = {
+  GET_ADMIN: 'get_admin',
+  GET_TOKEN: 'get_token',
+  GET_PERIOD: 'get_period',
+  GET_PERIOD_IDS: 'get_period_ids',
+  HAS_CLAIMED: 'has_claimed',
+  GET_BENEFICIARIES: 'get_beneficiaries',
+  UNCLAIMED_SUMMARY: 'unclaimed_summary',
+  GET_AUTHORIZED_OFFERINGS: 'get_authorized_offerings',
+} as const;
+
+/**
+ * Period metadata (decoded from get_period Result)
+ */
+export interface Period {
+  start_ledger: number;
+  end_ledger: number;
+  revenue_amount: bigint;
+  is_complete: boolean;
+}
+
+/**
+ * Unclaimed summary entry (from unclaimed_summary Map)
+ */
+export interface UnclaimedEntry {
+  period_id: number;
+  amount: bigint;
+}
+
+/**
+ * Creates an RPC server instance for Soroban
+ * Exported for testing purposes
+ */
+export const createRpcServer = () => new rpc.Server(RPC_URL);
+
+/**
+ * Internal: get RPC server (allows override in tests)
+ */
+let _rpcServerFactory = createRpcServer;
+
+export function setRpcServerFactory(factory: () => any) {
+  _rpcServerFactory = factory;
+}
+
+export function resetRpcServerFactory() {
+  _rpcServerFactory = createRpcServer;
+}
+
+/**
+ * Query the contract's admin address
+ */
+export async function getAdmin(): Promise<string> {
+  const server = _rpcServerFactory();
+  const { result } = await server.queryContract<string>(
+    CONTRACT_ID,
+    CONTRACT_METHODS.GET_ADMIN,
+    undefined,
+    NETWORK_PASSPHRASE,
+  );
+  return result;
+}
+
+/**
+ * Query the contract's token address
+ */
+export async function getToken(): Promise<string> {
+  const server = _rpcServerFactory();
+  const { result } = await server.queryContract<string>(
+    CONTRACT_ID,
+    CONTRACT_METHODS.GET_TOKEN,
+    undefined,
+    NETWORK_PASSPHRASE,
+  );
+  return result;
+}
+
+/**
+ * Query all period IDs registered with the contract
+ */
+export async function getPeriodIds(): Promise<number[]> {
+  const server = _rpcServerFactory();
+  const { result } = await server.queryContract<number[]>(
+    CONTRACT_ID,
+    CONTRACT_METHODS.GET_PERIOD_IDS,
+    undefined,
+    NETWORK_PASSPHRASE,
+  );
+  return result;
+}
+
+/**
+ * Query period metadata for a specific period
+ * Returns the period data or null if the period doesn't exist
+ */
+export async function getPeriod(periodId: number): Promise<Period | null> {
+  const server = _rpcServerFactory();
+  try {
+    const { result } = await server.queryContract<Period>(
+      CONTRACT_ID,
+      CONTRACT_METHODS.GET_PERIOD,
+      { period_id: periodId },
+      NETWORK_PASSPHRASE,
+    );
+    return result;
+  } catch (error) {
+    // Return null if period doesn't exist or query fails
+    return null;
+  }
+}
+
+/**
+ * Query whether an address has claimed from a period
+ */
+export async function hasClaimed(periodId: number, address: string): Promise<boolean> {
+  const server = _rpcServerFactory();
+  const { result } = await server.queryContract<boolean>(
+    CONTRACT_ID,
+    CONTRACT_METHODS.HAS_CLAIMED,
+    { period_id: periodId, address },
+    NETWORK_PASSPHRASE,
+  );
+  return result;
+}
+
+/**
+ * Query the beneficiary list for a period
+ */
+export async function getBeneficiaries(periodId: number): Promise<string[] | null> {
+  const server = _rpcServerFactory();
+  try {
+    const { result } = await server.queryContract<string[]>(
+      CONTRACT_ID,
+      CONTRACT_METHODS.GET_BENEFICIARIES,
+      { period_id: periodId },
+      NETWORK_PASSPHRASE,
+    );
+    return result;
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Query unclaimed summary map (period_id -> unclaimed_amount)
+ */
+export async function getUnclaimedSummary(): Promise<UnclaimedEntry[]> {
+  const server = _rpcServerFactory();
+  const { result } = await server.queryContract<Record<number, bigint>>(
+    CONTRACT_ID,
+    CONTRACT_METHODS.UNCLAIMED_SUMMARY,
+    undefined,
+    NETWORK_PASSPHRASE,
+  );
+  
+  // Convert Record to array of entries
+  return Object.entries(result).map(([periodId, amount]) => ({
+    period_id: Number(periodId),
+    amount,
+  }));
+}
+
+/**
+ * Query the list of authorized offering contract addresses
+ */
+export async function getAuthorizedOfferings(): Promise<string[]> {
+  const server = _rpcServerFactory();
+  const { result } = await server.queryContract<string[]>(
+    CONTRACT_ID,
+    CONTRACT_METHODS.GET_AUTHORIZED_OFFERINGS,
+    undefined,
+    NETWORK_PASSPHRASE,
+  );
+  return result;
+}
+
+/**
+ * Get a summary of contract state for display purposes
+ * Combines multiple read-only calls into a single summary object
+ */
+export async function getContractSummary() {
+  try {
+    const [admin, token, periodIds, authorizedOfferings] = await Promise.all([
+      getAdmin(),
+      getToken(),
+      getPeriodIds(),
+      getAuthorizedOfferings(),
+    ]);
+
+    return {
+      admin,
+      token,
+      periodCount: periodIds.length,
+      periodIds,
+      authorizedOfferingsCount: authorizedOfferings.length,
+    };
+  } catch (error) {
+    throw new Error(`Failed to fetch contract summary: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}