BAPBA Protocol
GuidesHost Guides

Liveness Settings

Configuring liveness check intervals, response times, and retry attempts in Burning Ash Protocol.

Liveness Settings

Liveness settings control how often the system checks if you're alive and what happens if you don't respond. This guide covers all configuration options.

Overview

Three parameters control liveness checks:

ParameterFull NameWhat It Controls
HCITHost Check-In Interval TimeHow often checks occur
HCRTHost Check-In Response TimeHow long to respond
HCRACHost Check-In Retry Attempt CountFailures before activation

Accessing Settings

  1. Log into Host Dashboard
  2. Go to SettingsLiveness
  3. Configure parameters

Parameter Details

HCIT — Check Interval

How often you're sent a liveness check notification.

Options: 7, 14, 30, 60, or 90 days

SettingUse Case
7 daysFrequent confirmation, quick transfer if death
14 daysBalance of frequency and convenience
30 daysDefault — Recommended for most users
60 daysLess frequent, for confident users
90 daysMinimal maintenance, longer delay

Recommendation: 30 days is the sweet spot for most people.

HCRT — Response Time

How long you have to respond to each check before the next attempt.

Options: 24, 48, or 72 hours

SettingUse Case
24 hoursFast response expected
48 hoursDefault — Good balance
72 hoursMore time, accounts for travel/illness

Recommendation: 48 hours gives you time to respond even if traveling or temporarily unavailable.

HCRAC — Retry Attempts

How many missed checks before the will transfer activates.

Options: 1, 2, 3, 4, or 5 attempts

SettingUse Case
1 attemptFastest activation, highest false-positive risk
2 attemptsQuick but more forgiving
3 attemptsDefault — Good balance
4-5 attemptsVery forgiving, slow activation

Recommendation: 3 attempts is the default and works well.

Time to Activation

The dashboard calculates "Time to Activation" — worst case from last confirmed alive:

Time to Activation = HCRT × HCRAC

Examples

SettingsCalculationTotal Time
7/24/124 × 1~8 days
14/48/248 × 2~17 days
30/48/348 × 3~36 days
60/72/572 × 5~75 days
90/72/572 × 5~105 days

Warnings

The dashboard warns if settings are:

  • Too aggressive: Less than 14 days to activation
  • Too lenient: More than 180 days to activation

Notification Flow

Normal Check

Day 0: Check sent (via preferred connector)


Day 0-2 (HCRT): You have time to respond


Day 2: If you respond → Confirmed, next check scheduled for HCIT
       If no response → Increment retry count

Escalation

If you don't respond within HCRT:

Attempt 1: Failed


Attempt 2: Sent via next connector


Attempt 3: Sent via another connector


After HCRAC failures: Transfer initiated

Fallback Connectors

Each attempt may use a different connector:

  1. Primary connector (e.g., email)
  2. Secondary connector (e.g., SMS)
  3. Tertiary connector (e.g., Telegram)

This ensures you receive notifications even if one delivery method fails.

Configuration Best Practices

For Most Users

HCIT: 30 days
HCRT: 48 hours  
HCRAC: 3 attempts

Total: ~36 days to activation

This gives you:

  • Monthly check-ins
  • 2 days to respond to each
  • 3 misses allowed
  • ~5 weeks if you completely disappear

For Elderly Users

HCIT: 14 days
HCRT: 72 hours
HCRAC: 2 attempts

Total: ~17 days to activation

More responsive to potential death, but may have false positives.

For Forgetful Users

HCIT: 60 days
HCRT: 72 hours
HCRAC: 5 attempts

Total: ~75 days to activation

Very forgiving, but slower in case of actual death.

For Active Users

HCIT: 14 days
HCRT: 24 hours
HCRAC: 1 attempt

Total: ~8 days to activation

Quick activation if you die, but higher risk of accidental activation.

Changing Settings

While Will is Inactive

Settings can be changed anytime if will is in draft.

While Will is Active

Settings can be changed but:

  • New settings apply to next check cycle
  • Changes don't affect in-progress checks
  • Settings are stored encrypted

Impact on Active Will

If you change settings while will is active:

  1. Current check cycle completes with old settings
  2. Next check uses new settings
  3. If already in escalation, continues with old settings

Monitoring

Check History

Dashboard shows history:

DateCheck #StatusChannelResponse Time
Jan 155✅ ConfirmedEmail2 hours
Dec 154✅ ConfirmedEmail15 min
Nov 153❌ Missed--
Nov 133✅ ConfirmedSMS1 hour

Next Check Display

Dashboard shows:

  • Next check due: January 15, 2026
  • Last check: January 15, 2026 ✅
  • Status: On track

Manual Check

Trigger Manual Check

You can trigger a manual check anytime:

  1. Go to WillLiveness
  2. Click "Check Now"
  3. System sends check via your primary connector

This is useful if:

  • You want to confirm alive before travel
  • You missed a check and want to reset
  • Testing the system

Cancel Pending Check

If you have a pending check:

  • Simply responding to it cancels escalation
  • No explicit cancel needed

Survivor-Initiated Transfer

Survivors can initiate transfer manually regardless of your liveness settings.

See Liveness Checks for details on survivor-initiated transfer.

Troubleshooting

"Not receiving checks"

  1. Check connector configuration
  2. Verify email isn't in spam
  3. Test connector delivery
  4. Add backup connectors

"Check marked as missed incorrectly"

  1. Check your email for notifications
  2. Check spam/junk folders
  3. Look at different connectors

"Can't change settings"

  • Ensure will is in active/draft state
  • Contact support if system error

API Reference

Liveness can also be configured via API:

GET /api/host/settings     - Get current liveness settings
PUT /api/host/settings    - Update liveness settings
POST /api/liveness/alive  - Confirm alive
GET /api/liveness/history - Get check history

See API Reference - Hosts for details.

Summary

ParameterRecommendationAlternative
HCIT30 days14-60 days
HCRT48 hours24-72 hours
HCRAC3 attempts2-5

The defaults (30/48/3) work well for most users. Adjust based on your comfort level and needs.

Next Steps

On this page